So someone had asked "how to do I work on the Wiki", and I was
thinking you needed to check it out due to commit level access. I was
wrong, everyone can edit if you have
a github account. I think this lowers the barrier to Wiki editing
*nicely* and github makes reverting commits easily, so I'm not too
worried about spam. So get a
github.com account
and you're good to go!
How to identify what needs migrating:
On the new Wiki, there are a lot of pages that say "content still on
fedorahosted.org..."/etc and have only a line of text. There are
about 60 of these, you can see them all here:
https://github.com/cobbler/cobbler/wiki/_pages
AND see the Trac versions here:
https://fedorahosted.org/cobbler/wiki/TitleIndex
What you need to do is find the corresponding page on
fedorahosted.org, and convert from Trac format to Markdown --
http://daringfireball.net/projects/markdown/syntax
Notice that the names of the pages are more spelled out on the new
Wiki. If a page isn't in the new list of pages, I haven't planned on
bringing it over, so some, like the Diagrams page, can be skipped.
We're done once no pages say "content over on fedorahosted", so maybe
if you start to edit one, update the content to say "migration in
progress by ___" so we don't duplicate
effort.
Once that's all done we can go back through and clean up documentation
that needs clarifications and updates.
--Michael
On Sun, Nov 20, 2011 at 3:18 PM, Michael DeHaan
<michael.dehaan(a)gmail.com> wrote:
I've started moving the Wiki/homepage over from
fedorahosted.org/cobbler to the github Wiki.
This is a little slow going as I need to convert from Trac format to
Markdown. Want to help over a slack Thanksgiving week at work?
You can git clone the Wiki and then send me a pull request.
git://github.com/cobbler/cobbler.wiki.git
https://github.com/cobbler/cobbler/wiki
old documentation will live at
fedorahosted.org/cobbler forever, most
likely, but we'll insert a BIG pointer to the new site so folks know
where the master copy is.
The new home page exists to summarize the project and point folks to
the appropriate resources, and probably needs some shiny pictures at
some point.
http://cobbler.github.com/
That is also forkable over github and can be contributed to via pull requests:
https://github.com/cobbler/cobbler.github.com
Also the issue tracker is now live, so we'll discontinue usage of Trac:
https://github.com/cobbler/cobbler/issues
Basically don't add anything new to Trac, as chances are it won't get
ported over. Scott was going to move over the important bugs so we
won't lose those.
--Michael