On 18/03/15, Pete Travis wrote: > Hey cloud team, > > I think we need some cloud docs. Fedora has a lot to offer in the cloud > area, and I'm sure that those engaged in the space are excited that > Fedora has what they are looking for. The uninitiated, on the other > hand, are looking for what Fedora has, and we can do better to > demonstrate that. > > We have a cloud guide, > https://git.fedorahosted.org/cgit/docs/cloud-guide.git/ . It covers > some basics, ie euca2ools, but never really made it out of draft state, > and your work has left it far behind. We don't have anyone on the Docs > team fully engaged to track the cloud space, or anyone on the cloud team > engaged to maintain that guide. Also, it's written in docbook, and a > lot of folks aren't into that. > > So, as I'm working on some tooling for a new Fedora Docs site, I'd like > to know what would get *you* into writing about Fedora Cloud. In the > most direct sense, it's a question about markup and delivery, ie a > collection of markdown or reStructuredText files in a git repo. In a > broad sense, anything along the lines of "I would write docs for using > Fedora Cloud, if..." would be great. Personally it will be easier if we start using Sphinx along with reStructruedText. Most of the documents I write[1] or manage[2] are in Sphinx using rst. It required I can provide IRC classroom trainings and other training material to get anyone into Sphinx within few hours. We can have a Fedora focused theme for Sphinx projects. [1] http://worknotes.rtfd.org [2] http://tunir.rtfd.org [3] http://pymbook.rtfd.org Kushal -- Fedora Cloud Engineer CPython Core Developer Director @ Python Software Foundation http://kushaldas.in _______________________________________________ cloud mailing list cloud@xxxxxxxxxxxxxxxxxxxxxxx https://admin.fedoraproject.org/mailman/listinfo/cloud Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
