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? Yes. > 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
