Hi Eric, To discuss CloudStack Documentation, best is dev@ mailing list. there is some Jira issues related to documentations too. related to guidelines, as Erik said it's all in github and if you want to enhance the look and feel, feel free to change it as the sphinx theme is now included in Git repos.
Cheers, On Tue, Oct 20, 2015 at 7:08 PM, Eric <epretori...@yahoo.com.invalid> wrote: > Thanks, Erik! > Is there a discussion forum where contributors can discuss documentation? > I believe that, like all things in technology, there should be a set of > conventions that guide authors in the use of common terms. e.g., Xen? Or > Xen Project? Or XenServer? > > Eric PretoriousPortland, OR > > From: Erik Weber <terbol...@gmail.com> > To: dev <dev@cloudstack.apache.org>; Eric <epretori...@yahoo.com> > Sent: Sunday, October 18, 2015 11:50 PM > Subject: Re: Getting Started With Documentation > > On Sun, Oct 18, 2015 at 10:16 PM, Eric <epretori...@yahoo.com.invalid> > wrote: > > Hello, All: > > > > Hi Eric! > > > > I'd like to contribute to the Cloudstack project documentation. > > > That's excellent! > > > > > > What's the process for that? Is there a SIG? Are there guidelines or a > style guide? > > > We use ReStructuredText to write our documentation and and readthedocs to > display them. > Generally there are two ways to edit the documentation. > > 1) Edit it on GitHub. Go to any source file and press the 'Fork this > project and edit the file'. This method gives easy access, but it is harder > to preview the result, and you are stuck with the GitHub UI > 2) Fork the project(s) and edit in your favorite editor. This requires > that you have or learn some basic git knowledge. > > You can find the following repositories on GitHub: > > Administration guide: https://github.com/apache/cloudstack-docs-admin > Installation guide: https://github.com/apache/cloudstack-docs-install > Getting started: https://github.com/apache/cloudstack-docs > Release notes: https://github.com/apache/cloudstack-docs-rn > > As for guidelines and/or style guides I'm not sure we have any, I guess we > are open for suggestions :-) > > > -- > Erik Weber > > > > >
