Open Stack

now I'm subscribed and can send this...

See full thread on openstack-discuss,
Andreas


-------- Forwarded Message --------
Subject: Re: [docs][tc][infra][uc][sdk] what to do with
developer.openstack.org and api-site?
Date: Tue, 16 Jul 2019 19:42:30 +0200
From: Andreas Jaeger <aj at suse.com>
Organization: SUSE Linux GmbH, GF: Felix Imendörffer, Jane Smithard,
Graham Norton, HRB 21284 (AG Nürnberg) To:
openstack-discuss at lists.openstack.org
<openstack-discuss at lists.openstack.org>,
user-committee at lists.openstack.org <user-committee at lists.openstack.org>

Let me add some more tags and cross-post to user-committee and reword.

The api-site repo is orphaned, it is used to publish the content of
developer.openstack.org. I propose now the following actions:


* Move OpenStack API-Guide to openstack-manuals repo and publish to
docs.o.o (currently published at
https://developer.openstack.org/api-guide/quick-start/)
* Add a redirect for this on developer.o.o

* Kill the "Writing Your First OpenStack Application" document,
  since it's completely dead and outdated (last non-trivial change
  was 22nd February 2017).
  This is currently published to
  https://developer.openstack.org/firstapp-libcloud/ and
  https://developer.openstack.org/firstapp-shade/

* Publish all api-guide and api-ref documents to docs.openstack.org, add
  redirects for them on developer.openstack.org

* List SDKs and CLIs on the software page on www.openstack.org (Thierry
plans to do this)

* Remove landing page from developer.o.o, add redirects.

* After some time, retire developer.o.o and api-site repo completely.

I've started pushing changes with topic retire-api-site,
 https://review.opendev.org/#/q/topic:retire-api-site

Will WIP until Monday, 22nd of July.

If any team wants to adopt api-site completely, or parts of it, please
speak up, happy to help a hand-over - or wait a bit longer if further
discussion is needed,

Andreas
-- 
 Andreas Jaeger aj at suse.com Twitter: jaegerandi
  SUSE Software Solutions Germany GmbH, Maxfeldstr. 5, D 90409 Nürnberg
   GF: Nils Brauckmann, Felix Imendörffer, Enrica Angelone,
       HRB 247165 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126