Merge pull request open5e#571 from open5e/409-how-to-build-and-self-host

Address self-hosting.

Author: augustjohnson

README.md

@@ -101,12 +101,14 @@ Run the server locally. This server is only for development and shall __not__ be
 pipenv run python manage.py runserver
 ```
 
-If you need to run the server on another port, add the port number as an argument.
+### Self-hosting
+If you would like to host the API yourself locally, we suggest using gunicorn as your wsgi server. Below is an equivalent command to what we use in production, which makes the server available at `http://localhost:8888`.
 
 ```bash
-pipenv run python manage.py runserver $PORT
+gunicorn -b :8888 server.wsgi:application
 ```
 
+You can use our Dockerfile as inspiration, but it likely will not work without significant edits to your operating environment. We have customized our production environment to use it.
 
 ## Building the OAS file
 

docs/v2/data.md

@@ -16,9 +16,9 @@ The actual data.
 > /data/v2/{publisher-key}/{document-key}/{model-name}.json.
 
 ## Keys
-Documents when onboarded are given a short key. To allow for data to be presented in the same views, even with conflicting data names, we by convention choose the keys of an individual data item to be <slugified-name>-<document-pk>, which should be unique in all cases.
+Documents when onboarded are given a short key. To allow for data to be presented in the same views, even with conflicting data names, we by convention choose the keys of an individual data item to be <document-key>_<slugified-name>, or for child objects, such as CreatureActions, <document-key>_<slugified-parent-name>_<slugified-name> which should be unique per object all cases. The only violation of this rule is on legendary actions, which are also CreatureActions, so Legendary Bite can be distinct from Bite.
 
 **Examples:**
-> magic-missile-srd - The original Magic Missile, from Wizard's of the Coast's Systems Reference Document (srd)
+> srd_magic-missile - The original Magic Missile, from Wizard's of the Coast's Systems Reference Document (srd)
 >
-> acolyte-a5e-ag - The Acolyte Background, from Advanced 5e's Adventurer's Guide (a5e-ag).
+> a5e-ag_acolyte - The Acolyte Background, from Advanced 5e's Adventurer's Guide (a5e-ag).