Why documentation is the way it is

Alan DeKok aland at deployingradius.com
Fri Mar 28 16:15:49 CET 2014


A.L.M.Buxey at lboro.ac.uk wrote:
> oh...whilst pretty much on the mark I'd say I disagree. you seem to have forgotten
> those that

  I wasn't planning on a an exhaustive list of mistakes.  But these
comments are good, too.

> 1) write up their own web pages with instructions and then dont update them when new stuff comes out (as 
> its no longer things they do) - which then cause problems for future people who use google to find
> documentation (just look at the history of this list and people quoting random 3rd party web sites.
> 
> sure, the people are meaning well - but the documentation really should be centralised and
> kept up to date

  Yes.  The Wiki exists for a purpose.  EDIT IT!  Why the heck are they
updating their pages, that no one else will ever be able to find?

> 2) post after a long thread with 'I've now got it working' - but actually dont post
> any further details or feedback

  Yes... very frustrating.

  Alan DeKok.


More information about the Freeradius-Users mailing list