Looking for an editor for FreeRADIUS documentation
aland at deployingradius.com
Thu Jun 10 22:44:27 CEST 2010
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.
> 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.
More information about the Freeradius-Users