not logged in | [Login]
One of the largest complaints with FreeRADIUS is the lack of comprehensive documentation.
The previous wiki has served its purpose, but has ultimately failed to provide an up-to-date, well organised source of documentation.
The major problems with the previous wiki were:
To try and solve these issues and glue everything together a bit more, we setup this new wiki based on Gollum. Gollum is a ruby on rails application which exposes a git repository as wiki site. Gollum can render files in many markup languages including plaintext, RST and Mediawiki format, which means we can import all current server documentation, all current wiki documentation and have them neatly presented in a single wiki site. Neat huh?
But what about spam and registration? Well by default gollum doesn't authenticate anyone. But because it's a rails application we can drop in a library called 'OmniAuth' which uses Oauth to authenticate a bunch of providers.
This allows us to leverage authentication and spam account prevention services of providers like GitHub, Facebook and Twitter.
Unfortunately the new wiki needs some fixes. The mediawiki page format renderer in gollum isn't perfect, so we need to convert the pages which don't render correctly to RST as a priority.
If you want to help out, please do the following:
Also please report any bugs here: gollum issue tracker
Last edited by Arran Cudbard-Bell (arr2036), 2013-01-20 22:10:55
Sponsored by Network RADIUS