[openstack-dev] [kolla] Structuring the documentation on all repositories

Christian Berendt berendt at betacloud-solutions.de
Mon Feb 20 16:34:05 UTC 2017


This is a summary about structuring the documentation on all repositories as discussed at the PTG (https://etherpad.openstack.org/p/kolla-pike-ptg-docs).

The doc directory:

kolla/doc — kolla developer documentation (about our docker images) and generic documentation
kolla-ansible/doc — kolla-ansible developer documentation
kolla-k8s/doc — kolla-k8s developer documentation

Contents will be published to https://docs.openstack.org/developer/kolla…/

The doc directory in the kolla repositories will be splitted into 2 parts and will keep the generic kolla documentation (landing page, mission, philosophy, explanation of deliverables, overview of deployment guides (previous QSG), bug triage, how to contribute, ...) and the development documentation related to kolla images.

The central entry point (landing page) for the kolla project will be https://docs.openstack.org/developer/kolla.

The deploy-guide directory:

kolla-ansible/deploy-guide — Kolla deployment guide for Ansible, how to deploy with kolla-ansible (previous name: quick start guide)
kolla-k8s/deploy-guide — Kolla deployment guide for K8S, how to deploy with kolla-k8s (previous name: quick start guide)

We will add 2 links to https://docs.openstack.org/project-deploy-guide/ocata/:

* Kolla deployment guide for Ansible
* Kolla deployment guide for K8S

Sample split for kolla-ansible prepared at https://review.openstack.org/#/c/427965/.

The guides itself will be published at https://docs.openstack.org/project-deploy-guide/ocata/kolla-ansible and https://docs.openstack.org/project-deploy-guide/ocata/kolla-k8s.

Christian.

-- 
Christian Berendt
Chief Executive Officer (CEO)

Mail: berendt at betacloud-solutions.de
Web: https://www.betacloud-solutions.de

Betacloud Solutions GmbH
Teckstrasse 62 / 70190 Stuttgart / Deutschland

Geschäftsführer: Christian Berendt
Unternehmenssitz: Stuttgart
Amtsgericht: Stuttgart, HRB 756139




More information about the OpenStack-dev mailing list