Update README.org

README.org

@@ -5,9 +5,9 @@ originally based on [[https://github.com/flaghunters/Extra-Flags-for-4chan][extr
  [[https://flags.plum.moe/bantflags.user.js][Install bantflags]]
 
 ** Userscript
-The userscript takes advantage of =GM_xmlhttpRequest= to get and set flags with 
+The userscript uses of =GM_xmlhttpRequest= to get and post flags with
-the backend. A user's flags are stored between pages using =GM_setValue= and
+the backend . A user's flags are stored between pages using
-=GM_getValue=.
+=GM_setValue= and =GM_getValue=.
 
 Old versions of GreaseMonkey will be able to recieve updates to the
 script through use of the =@updateURL= and =@downloadURL= directives,
@@ -38,24 +38,31 @@ declarations. Update your hecking browser.
 
 *** Setup
 1. Install .NET
-2. Clone and build the BantFlags .NET project.
+2. Clone and build the BantFlags solution.
 3. Create the database using =database.sql=.
   + *Change the password*.
 4. configure =BantFlags/appsettings.example.json= with your connection
-   string and webroot (the directory you wish to serve the flags from)
+   string and webroot (the working directory / where you'll serve the
-   and rename it to =appsettings.json=
+   flags from) and rename it to =appsettings.json=
   + The location of the BantFlags application and the served content
     are not necessarly the same. If you leave it empty, or provide a
     nonexistant path the application will look for the =wwwroot=
     folder inside the working directory.
+    + For example, you may place =BantFlags.dll= and
+ =appsettings.json= in =/etc/bantflags/= and point =webroot= at
+ =/var/www/html= and bantflags will server static content from
+      that directory, or leave =webroot= empty and bantflags will look
+      for static content in =/etc/bantflags/wwwroot=
   + This should be placed either in inside the working directory or
     the same directory as the program.
 5. Add flags to the backend (currently only possible by querying the
    database directly), and place image *with the same name* in
  ={webroot}/flags/=.
 6. Configure your webserver of choice to forward requests to kestral
-  + Example nginx config.
+  + [[https://github.com/C-xC-c/BantFlags/tree/master/environment/nginx.conf][Example nginx config.]]
-7. Run the application
+7. Run with =dotnet BantFlags.dll= or create a service to run it as a
+   daemon.
+  + [[https://github.com/C-xC-c/BantFlags/tree/master/environment/bantflags.service][Example systemd service.]]
 8. ???
 9. profit.
 
@@ -75,16 +82,7 @@ Tables look like this:
 |  2 |       1 |    2 |
 |  2 |       2 |    2 |
 where post_nr and flag in *postflags* are the id fields in their
-respective tables. 
+respective tables.
-
-extraflags stores all of a post's flags in one table as a varchar,
-seperated by "||", which is split and joined by the script when
-getting and posting respectively. This is extraordinarily inefficient,
-but for their purposes it's not such a glaring issue (the highest
-amount of flags I've seen is 6). One aim of this rewrite is to
-greatly increase the amount of flags usable at once, and this database
-structure allows the maximum to be arbitrarily high.
-
 *** API
 The backend exposes three endpoints used by the userscript to get and
 post flags, and a flags directory storing the images themselves.
@@ -97,7 +95,8 @@ post flags, and a flags directory storing the images themselves.
 | /flags/*   | The flag images                            |
 
 ** Backwards Compatibility
-The API is 1:1 compatable with all previous versions of bantflags,
+The API is 1:1 compatable with all previous versions of bantflags, but
-but also encodes a new =version= variable when getting flags which
+also encodes a new =version= variable when getting flags which allows
-allows for breaking changes in the script while the backend only 
+for breaking changes in the script while the backend only sends data
-sends data it knows is parsable.
+it knows is parsable. See [[https://github.com/C-xC-c/BantFlags/tree/master/Docs/][Docs/{endpoint}]]
+for version compatibility.