diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst
index 6aacc287d..33b065c8a 100644
--- a/docs/source/api/index.rst
+++ b/docs/source/api/index.rst
@@ -2,9 +2,9 @@
 
     <div id="banner"><a href="https://github.com/jcbrand/converse.js/blob/master/docs/source/theming.rst">Edit me on GitHub</a></div>
 
-=========================
-The new API documentation
-=========================
+=====================
+The API documentation
+=====================
 
 This document is a stub. It shouldn't show at all, instead it's a hack in order
 to link to the JSDoc output.
diff --git a/docs/source/development.rst b/docs/source/development.rst
index 3c7a7487d..2b6fe4a5e 100644
--- a/docs/source/development.rst
+++ b/docs/source/development.rst
@@ -23,7 +23,6 @@ or add new functionality to Converse.
    style_guide
    plugin_development
    api/index
-   developer_api
    events 
    other_frameworks
    builds
diff --git a/docs/source/jsdoc_intro.md b/docs/source/jsdoc_intro.md
index c86283311..eb663dd69 100644
--- a/docs/source/jsdoc_intro.md
+++ b/docs/source/jsdoc_intro.md
@@ -1,9 +1,15 @@
 # The Converse API documentation
 
+Welcome to the new Converse API documentation, generated with
+[JSDoc](http://usejsdoc.org/).
+
+The old (increasingly out of date and incomplete) API documentation is
+currently still [available here](/docs/htmls/developer_api.html).
+
 ## The public and private API
 
 Converse has a public API and a private API.
-
+r
 The reason we make this distinction between public and private is so that API
 methods which might can be used to "impersonate" the user, for example by
 sending messages on their behalf, are not available to random scripts running
@@ -12,7 +18,7 @@ in the websites.
 The public API is accessible via the `window.converse` global and is therefore
 available to all JavaScript running in the page.
 
-The private API is only accessible to plugins, which have been whitelisted and
+Tehe private API is only accessible to plugins, which have been whitelisted and
 registered before `converse.initialize` (which is a public API method) has been
 called. See the [plugin development](https://conversejs.org/docs/html/plugin_development.html)
 section for more info on writing plugins.