On 09/02/2015 02:48 PM, Anita Kuno wrote: > On 09/02/2015 02:09 PM, Emilien Macchi wrote: >> TL;DR, I propose to move our developer documentation from wiki to >> something like >> http://docs.openstack.org/developer/puppet-openstack > >> (Look at http://docs.openstack.org/developer/tempest/ for >> example). > > Looking at the tempest example: > http://git.openstack.org/cgit/openstack/tempest/tree/doc/source > we see that the .rst files all live in the tempest repo in doc/source > (with the exception of the README.rst file with is referenced from > within doc/source when required: > http://git.openstack.org/cgit/openstack/tempest/tree/doc/source/overview.rst) > > So question: Where should the source .rst files for puppet developer > documentation live? They will need a home.
I guess we would need a new repository for that. It could be puppet-openstack-doc (kiss) or something else, any suggestion is welcome. > > Thanks, > Anita. > > >> For now, most of our documentation is on >> https://wiki.openstack.org/wiki/Puppet but I think it would be >> great to use RST format and Gerrit so anyone could submit >> documentation contribute like we do for code. > >> I propose a basic table of contents now: Puppet modules >> introductions Coding Guide Reviewing code > >> I'm taking the opportunity of the puppet sprint to run this >> discussion and maybe start some work of people agrees to move on. > >> Thanks, > > > >> __________________________________________________________________________ > > > > OpenStack Development Mailing List (not for usage questions) >> Unsubscribe: >> openstack-dev-requ...@lists.openstack.org?subject:unsubscribe >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -- Emilien Macchi
signature.asc
Description: OpenPGP digital signature
__________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
