@zupo there is a problem here.  

If I set a url for a page to something like this:
    http://api.plone.org/about.html 
it does not redirect to the specific page.  Instead it redirects to the root of the documentation on developer.plone.org.  This is not so good.  It leaves us with two choices, either have all these links point directly to the equivalent page on developer.plone.org domain, or have all of the references go to the root of the docs on developer.plone.org.  

The other alternative would be to fix whatever redirect is in place to honor domain sub-paths.  Is that a possibility?  If not, I guess the developer.plone.org domain is the only choice :(

I has a sad here.  Any other ideas?