As zuliprc files are in a standard format that you can access from
any programming language, not just Python, it makes more sense to
have them documented with the information about API keys.
Fixes#10670.
Updates the placeholder in the curl examples of the API docs for
the user authentication line (-u) to be EMAIL_ADDRESS:API_KEY.
Adds text to the top of the curl tab about the user authentication
line with links to the curl man doc and the authorization header
section of the HTTP headers article.
If the endpoint does not have the user auth line (e.g., fetching
an API key in dev and production), then the text is not added to
the curl tab.
Fixes#479.
Expands the section on the `Authorization` header to include
the basic structure of the `Basic` auth credentials in the Zulip
API and information for how to get those credentials for bots
and users.
Cleans up some formatting, revises the tip at the top of the page
and adds a link to the `man curl` doc online.
This reverts commit 5c2b0d91d5. 2000
requests per minute is quite possible for legitimate users to hit if
they have multiple tabs or clients open to the server.
Adds a page to the general api documentation about HTTP headers,
so that information about the special response headers for rate
limits have a more logical location in the docs and so that other
HTTP header information can be shared, such as `User-Agent`
conventions.
Adjusts some text and linking on the rest-error-handling page and
overview page for the REST API for the addition of the HTTP headers
page.
