Looking for an editor for FreeRADIUS documentation
bjlockie at lockie.ca
Fri Jun 11 02:51:10 CEST 2010
On 06/10/10 16:44, Alan DeKok wrote:
> Arran Cudbard-Bell wrote:
>> My idea was to install an extension to the wiki that allowed rendering of RST. The documentation would be kept up to date on the wiki, and at official release time those pages would be pulled in from the wiki and bundled with the rest of FreeRADIUS.
> Ok. The RST format looks a lot easier than the Wiki format.
I'm trying to get this installed:
>> Advantaged are:
>> - Easy to edit
>> - No learning curve for GIT
>> - Still maintains blame information
>> - Instant feedback with the preview function when testing out syntax
>> - One source for all documentation
>> - Documentation available without downloading package or src bundle.
>> People are far more likely to contribute if the barrier to entry is low. The reason for the wikis zombie like status is, as other people have stated that there is no official procedure to request an account, and no automated account creation. I remember the issues with spam, so auto account creation is out. Maybe have a a registration mailing list where people can pick requests off and create the accounts manually?
>> The barrier to get an account has to be sufficiently high that spammers won't go through the hassle and sufficiently low that people will still contribute.
> We're also not in the business of account management. Someone like
> github.com is. If they had a Wiki that was RST *and* backed by git, it
> would be a clear winner. But people have been asking since 2008, and
> it's still not ready.
> Alan DeKok.
> List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html
More information about the Freeradius-Users