Docs: how can new users try creating a dataset? #129

Hello, and thank you for merging the documentation update #126. I tested the getting-started tutorial as a new user to see what I could do next. Reading a dataset works, but I cannot complete the dataset creation part.

I created an API token on data.humdata.org, as described in "Obtain your API Key", and used it with hdx_read_only=False. Step 9 of the tutorial uses hdx_site="stage" for writing:

from hdx.api.configuration import Configuration
from hdx.data.hdxobject import HDXError
from hdx.data.user import User

Configuration.create(hdx_site="stage", user_agent="stage_access_repro")
try:
    User.get_current_user()
except HDXError as e:
    print(e)
    print(repr(e.__cause__))

Output:

Failed when trying to show! (POST)
NotAuthorized({'__type': 'Authorization Error', 'message': 'Access denied'})

The same code with hdx_site="prod" authenticates (User.get_current_user() returns my username), which seems to prove that the issue comes from the stage site. That account has no organisation, so it cannot create datasets on prod, which matches the message on the "Add Data" page from data.humdata.org. I believe that is intended.

The demo site (for example https://demo.data-humdata-org.ahconu.org/, which the README uses for test_ckan.py) returns HTTP 401 for a plain request, so I assume outside users can't use them. Because of this, the tutorial's write steps can't be followed by an outside reader.

Questions:

1. What should an outside reader use to practise creating and updating a dataset: a public test site, a sandbox organisation, or something else?
2. If there is no such option, would you be happy with a tutorial that builds and validates the dataset locally and shows create_in_hdx() as the step for organisation members?
3. Who do you see as the main readers of the docs (publishers inside organisations, data analysts reading data, or both)? That would help me choose what to write first.

I am happy to write the tutorial and a "Troubleshoot common errors" how-to page, but I want them to match what you would actually point new users to.

Best,
Antonin