I've updated the main github site:
http://cobbler.github.com/
The goal of this redesign is to make the website much more accessible,
with documentation that's easier to find than digging through the
github wiki. It also provides a blog format, which I hope to use for
tips, how-tos, and other announcements in the future.
Going forward, there will be a manual for each major release (starting
now with 2.2.3). This will allow us to provide documentation for users
on older versions while maintaining updated docs for new releases (and
maybe even the devel branch, as new features are added). Right now,
the manual page is essentially a sorted hierarchy of the wiki pages,
with a LOT of holes in it. Not everything has been given subsection
numbers, so things are pretty jumbled. I'm continuing to work on this,
and I hope that by releasing this now others will start going through
the manual pages and fixing things as well.
If you would like to contribute to fixing up the documentation, clone
the
cobbler.github.com repo and start sending pull requests. All you
need installed is the jekyll ruby gem and python-pygments to test it
out. Since github runs their pages with jekyll's "safe mode" enabled,
plugins don't work. This means you need to:
1) Edit the .md files under the _dynamic/manuals directory
2) Run the generate_dynamic.sh script to compile everything into HTML
files. This script copies files _dynamic/_site/manuals/ to the root
manuals/ directory.
3) Use jekyll --server to test things out
4) Run "git add" on everything that changed and commit.
5) Send a pull request
Enjoy!