I've been making noises about writing documentation for a long time now. Too long. However, I've had a documentation person working on the problem for a few months now, and we have something ready for release. I hope this news has a positive impact on the FreeRADIUS community. There has been a lot of discussion recently around the subject of documentation, and I'd like people to know that I have been making progress. The documentation is available online at: http://networkradius.com/doc/ The astute reader will notice that the documentation isn't GPLd, and is instead from my company. The simple reason is that it costs money to have a professional person write documentation. So the documentation has to be owned by the entity who paid for it: Network RADIUS SARL. I plan on releasing more documentation in the next few months. There are a number of additional chapters nearly ready to go. There are a number more which need a lot of work. Please provide feedback. Is it good? Are there typos? What else needs documenting? Despite the documents being corporate branded, they are available for free download, for anyone to read. The company will continue to fund development of the documentation, and will continue to release more documentation over the coming months. Alan DeKok.
Fantastic! I skimmed it too fast to look for typos, but the random bits I slowed down to read in detail seem to be the kind of context that should be very helpful. Still needs pictures ;). I'll still be willing to work on that, unless that's already on your documentation person's to-do list... Steve Lovaas -----Original Message----- From: freeradius-users-bounces+steven.lovaas=colostate.edu@lists.freeradius.org [mailto:freeradius-users-bounces+steven.lovaas=colostate.edu@lists.freeradius.org] On Behalf Of Alan DeKok Sent: Friday, March 28, 2014 12:51 PM To: FreeRadius users mailing list Subject: New documentation is available online I've been making noises about writing documentation for a long time now. Too long. However, I've had a documentation person working on the problem for a few months now, and we have something ready for release. I hope this news has a positive impact on the FreeRADIUS community. There has been a lot of discussion recently around the subject of documentation, and I'd like people to know that I have been making progress. The documentation is available online at: http://networkradius.com/doc/ The astute reader will notice that the documentation isn't GPLd, and is instead from my company. The simple reason is that it costs money to have a professional person write documentation. So the documentation has to be owned by the entity who paid for it: Network RADIUS SARL. I plan on releasing more documentation in the next few months. There are a number of additional chapters nearly ready to go. There are a number more which need a lot of work. Please provide feedback. Is it good? Are there typos? What else needs documenting? Despite the documents being corporate branded, they are available for free download, for anyone to read. The company will continue to fund development of the documentation, and will continue to release more documentation over the coming months. Alan DeKok. - List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html
On 28 Mar 2014, at 19:47, Lovaas,Steven <Steven.Lovaas@ColoState.EDU> wrote:
Fantastic! I skimmed it too fast to look for typos, but the random bits I slowed down to read in detail seem to be the kind of context that should be very helpful.
Still needs pictures ;). I'll still be willing to work on that, unless that's already on your documentation person's to-do list...
Sure, diagrams appreciated. Though if you're going to contribute please use omnigraffle so we can edit the source and keep them up to date. I haven't found a vector graphics format that really works between multiple design programs. -Arran
Steve Lovaas
-----Original Message----- From: freeradius-users-bounces+steven.lovaas=colostate.edu@lists.freeradius.org [mailto:freeradius-users-bounces+steven.lovaas=colostate.edu@lists.freeradius.org] On Behalf Of Alan DeKok Sent: Friday, March 28, 2014 12:51 PM To: FreeRadius users mailing list Subject: New documentation is available online
I've been making noises about writing documentation for a long time now. Too long. However, I've had a documentation person working on the problem for a few months now, and we have something ready for release.
I hope this news has a positive impact on the FreeRADIUS community. There has been a lot of discussion recently around the subject of documentation, and I'd like people to know that I have been making progress.
The documentation is available online at:
The astute reader will notice that the documentation isn't GPLd, and is instead from my company. The simple reason is that it costs money to have a professional person write documentation. So the documentation has to be owned by the entity who paid for it: Network RADIUS SARL.
I plan on releasing more documentation in the next few months. There are a number of additional chapters nearly ready to go. There are a number more which need a lot of work.
Please provide feedback. Is it good? Are there typos? What else needs documenting?
Despite the documents being corporate branded, they are available for free download, for anyone to read. The company will continue to fund development of the documentation, and will continue to release more documentation over the coming months.
Alan DeKok. - List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html - List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html
Arran Cudbard-Bell <a.cudbardb@freeradius.org> FreeRADIUS Development Team FD31 3077 42EC 7FCD 32FE 5EE2 56CF 27F9 30A8 CAA2
On 03/28/2014 02:51 PM, Alan DeKok wrote:
I've been making noises about writing documentation for a long time now. Too long. However, I've had a documentation person working on the problem for a few months now, and we have something ready for release.
I hope this news has a positive impact on the FreeRADIUS community. There has been a lot of discussion recently around the subject of documentation, and I'd like people to know that I have been making progress.
The documentation is available online at:
Wonderful, thank you Alan! This is very much appreciated.
The astute reader will notice that the documentation isn't GPLd, and is instead from my company. The simple reason is that it costs money to have a professional person write documentation. So the documentation has to be owned by the entity who paid for it: Network RADIUS SARL.
Despite the documents being corporate branded, they are available for free download, for anyone to read. The company will continue to fund development of the documentation, and will continue to release more documentation over the coming months.
I'd like to get a clarification concerning licensing of the doc. Saying it's corporate owned but free for download paints with a broad brush. How do you see this working? Is the idea Network RADIUS SARL owns the copyright and is the exclusive distributor meaning it can only be obtained from Network RADIUS SARL and reproduction in any form is prohibited? -- John
John Dennis wrote:
I'd like to get a clarification concerning licensing of the doc. Saying it's corporate owned but free for download paints with a broad brush. How do you see this working? Is the idea Network RADIUS SARL owns the copyright and is the exclusive distributor meaning it can only be obtained from Network RADIUS SARL and reproduction in any form is prohibited?
For now, yes. Arran and I have been discussing this offline. This restriction is the same as the "howtos" on my site http://deployingradius.com, so that's nothing new. Alan DeKok.
participants (4)
-
Alan DeKok -
Arran Cudbard-Bell -
John Dennis -
Lovaas,Steven