Just want to throw this plan out there to make sure no one strenuously objects. We have been talking about moving the entire site codebase (ie, what is displayed on public site) into the docs repo. The main reasons for this are: * The current docs (and other pages) are woefully out of date, and not enough people have the access or ability to update them * We don't want to deal with the old html duplication of layouts, etc
So, we looked into options for tools that could generate this from things like haml, sass, markdown, and others. We have settled on using one called webby (http://webby.rubyforge.org/). The plan is to use this to generate the html when we make updates and then someone can easily push this to the live site after local testing (eventually this will be automated). Following is our plan to make this happen. Right now, Steve and I will be doing the work, but volunteers to help are welcome!
== The Plan ==
1. Create a temporary repo on fedorapeople. This has the benefit of being able to put the test version of the generated site up for review before pushing.
2. Build the basic infrastructure for the main site in webby there.
3. Once that is pretty functional, squash history (local repo, not on fp) into a reasonable patchset that we can either send to the list, or just push to docs repo.
4. Add in existing markdown api docs to work in new site structure, push this as another patch
5. Add any additional bits needed to generate diagrams for api
-j
deltacloud-devel@lists.fedorahosted.org