Now that we have decide that Web-APIs-Hub must be integrated with the API: namespace at mediawiki.org, we need to plan a good organization of the new content with the existing content (basically the documentation of api.php action API for any MediaWiki installation).
For a good integration, we need
- an agreement on the audiences (the personas) we are documenting for
- a consistent way to explain what is MediaWiki generic and what is Wikimedia specific
- a single landing page -- now we have https://www.mediawiki.org/wiki/API:Main_page and https://www.mediawiki.org/wiki/API:Data_and_developer_hub
- updates for other key pages i.e. API:Localisation, API:Calling internally, API:Client code, API:FAQ...