Re: Looking for an editor for FreeRADIUS documentation

2010-06-15 Thread Alan DeKok
James wrote: I did these: proxy.rst processing_users_file.rst cisco.rst variables.rst configurable_failover.rst There might be formatting errors but I think it is a good first pass. OK. I double-checked them, and put them into the git v2.1.x branch. The suse/redhat/debian package

Re: Looking for an editor for FreeRADIUS documentation

2010-06-13 Thread Alan DeKok
James wrote: Is somebody already working on making .rst files because there are already some? Peter Nixon did a few in the master branch. I don't think any more changes have been made since then. Alan DeKok. - List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html

Re: Looking for an editor for FreeRADIUS documentation

2010-06-13 Thread James
On 06/13/10 03:11, Alan DeKok wrote: James wrote: Is somebody already working on making .rst files because there are already some? Peter Nixon did a few in the master branch. I don't think any more changes have been made since then. Alan DeKok. - List info/subscribe/unsubscribe? See

Re: Looking for an editor for FreeRADIUS documentation

2010-06-13 Thread James
On 06/13/10 03:11, Alan DeKok wrote: James wrote: Is somebody already working on making .rst files because there are already some? Peter Nixon did a few in the master branch. I don't think any more changes have been made since then. Alan DeKok. - List info/subscribe/unsubscribe? See

Re: Looking for an editor for FreeRADIUS documentation

2010-06-12 Thread James
On 06/10/10 15:59, Alan DeKok wrote: bjloc...@lockie.ca wrote: What file format is the documentation in and roughly how big is it? Text. Not a lot, but organized fairly poorly. I'm a technical writer and I'm interested. Try: http://freeradius.org/doc/community.html Or, just

RE: Looking for an editor for FreeRADIUS documentation

2010-06-11 Thread Ramm-Ericson, Johannes
Hi, Peter Nixon wrote: Hi Johannes Please feel free to take the lead. While you may of course use the RST viewer built into github, its better if you install Sphinx (http://sphinx.pocoo.org/) as you will then be able to build the RST into html format locally on your machine with: make html

Re: Looking for an editor for FreeRADIUS documentation

2010-06-11 Thread Peter Nixon
On Fri 11 Jun 2010, Ramm-Ericson, Johannes wrote: Hi, Peter Nixon wrote: Hi Johannes Please feel free to take the lead. While you may of course use the RST viewer built into github, its better if you install Sphinx (http://sphinx.pocoo.org/) as you will then be able to build the RST

Re: Looking for an editor for FreeRADIUS documentation

2010-06-11 Thread Alan DeKok
Josip Rodin wrote: In the meantime I've done some work fixing the Wiki. I invite everyone watching to have a look, it's now... no longer stuck in 2007. :) It looks quite a bit better, thanks. Alan DeKok. - List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Josip Rodin
On Wed, May 19, 2010 at 03:01:47PM +0200, Alan DeKok wrote: Fajar A. Nugraha wrote: The enthusiasm seems big enough. So how would this work? http://freeradius.org/doc/community.html It doesn't seem to be particularly enthusiastic any more. But that's what happens in the real world :) A

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Peter Nixon
On Tue 18 May 2010, Alan DeKok wrote: Nyamul Hassan wrote: Not meaning any disrespect to the paid offer, you could also reconsider to put up the current documentation in a Wiki style webpage, and from there everyone can work on the text that they think needs reworking. We already

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread bjlockie
On Tue 18 May 2010, Alan DeKok wrote: Nyamul Hassan wrote: Not meaning any disrespect to the paid offer, you could also reconsider to put up the current documentation in a Wiki style webpage, and from there everyone can work on the text that they think needs reworking. We already

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Josip Rodin
On Thu, Jun 10, 2010 at 09:07:32PM +0300, Peter Nixon wrote: We already have a Wiki. Few people edit it. We already have a publicly available doc directory. Few people submit changes. Yes. I'll second Alan on this. It was my idea to setup the wiki, and I spent a LOT of time on it for

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Arran Cudbard-Bell
On Jun 10, 2010, at 11:38 AM, Josip Rodin wrote: On Thu, Jun 10, 2010 at 09:07:32PM +0300, Peter Nixon wrote: We already have a Wiki. Few people edit it. We already have a publicly available doc directory. Few people submit changes. Yes. I'll second Alan on this. It was my idea to

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Peter Nixon
It looks like a good set of volunteers wanting to help. My suggestion is to convert the docs to Restructured text: http://docutils.sourceforge.net/rst.html Looks very straight forward. :) I'll be creating a github account for myself later this evening and will start getting my

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Arran Cudbard-Bell
On Jun 10, 2010, at 12:11 PM, Josip Rodin wrote: On Thu, Jun 10, 2010 at 11:59:57AM -0700, Arran Cudbard-Bell wrote: That's why I mentioned that ConfirmAccount mediawiki extension - it will reduce the amount of bother for the admins, while still allowing the users to use minimal necessary

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Alan DeKok
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

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Alan DeKok
bjloc...@lockie.ca wrote: What file format is the documentation in and roughly how big is it? Text. Not a lot, but organized fairly poorly. I'm a technical writer and I'm interested. Try: http://freeradius.org/doc/community.html Or, just convert the existing txt to rst, and send them

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Josip Rodin
On Thu, Jun 10, 2010 at 11:59:57AM -0700, Arran Cudbard-Bell wrote: That's why I mentioned that ConfirmAccount mediawiki extension - it will reduce the amount of bother for the admins, while still allowing the users to use minimal necessary skills to do their edits. My idea was to install

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Josip Rodin
On Thu, Jun 10, 2010 at 10:44:27PM +0200, Alan DeKok wrote: 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.

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread Arran Cudbard-Bell
On Jun 10, 2010, at 2:48 PM, Josip Rodin wrote: On Thu, Jun 10, 2010 at 10:44:27PM +0200, Alan DeKok wrote: 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

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread bjlockie
bjloc...@lockie.ca wrote: What file format is the documentation in and roughly how big is it? Text. Not a lot, but organized fairly poorly. I'm a technical writer and I'm interested. Try: http://freeradius.org/doc/community.html Or, just convert the existing txt to rst, and send

Re: Looking for an editor for FreeRADIUS documentation

2010-06-10 Thread James
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

RE: Looking for an editor for FreeRADIUS documentation

2010-05-19 Thread Ramm-Ericson, Johannes
Alan DeKok wrote: Arran Cudbard-Bell wrote: The problem with volunteer 're-factoring' work, is that although people mean well when they offer their assistance, it doesn't usually work out... They'll often spend a couple of weeks working on the task, get bored, figure they'll take a break

Re: Looking for an editor for FreeRADIUS documentation

2010-05-19 Thread Ramon J. Castillo
Need to give something back to the Open Source community. So I'd very happy to contribute with this project. I have some experience contributing to standard bodies such as WBA which I'm the Cochair of RD and authored some of the stage 2 documents in the WiMAX Forum (GRWG) currently in RiLTE

Re: Looking for an editor for FreeRADIUS documentation

2010-05-19 Thread Alan DeKok
Fajar A. Nugraha wrote: The enthusiasm seems big enough. So how would this work? http://freeradius.org/doc/community.html Get some people to submit an example doc that they've converted, and then you pick one which is best and assign the job? Or get people to convert some/all docs, and

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Nyamul Hassan
Not meaning any disrespect to the paid offer, you could also reconsider to put up the current documentation in a Wiki style webpage, and from there everyone can work on the text that they think needs reworking. Regards HASSAN On Tue, May 18, 2010 at 13:16, Alan DeKok al...@deployingradius.com

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Alan DeKok
Nyamul Hassan wrote: Not meaning any disrespect to the paid offer, you could also reconsider to put up the current documentation in a Wiki style webpage, and from there everyone can work on the text that they think needs reworking. We already have a Wiki. Few people edit it. We already

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Ana Gallardo
I would like to do this job, but my english is poor, so I can't do it :( 2010/5/18 Alan DeKok al...@deployingradius.com Nyamul Hassan wrote: Not meaning any disrespect to the paid offer, you could also reconsider to put up the current documentation in a Wiki style webpage, and from there

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Nyamul Hassan
I tried to signup to be able to edit the Wiki, but it seems that signup is disabled! Regards HASSAN On Tue, May 18, 2010 at 14:02, Ana Gallardo ana.gallardo...@gmail.comwrote: I would like to do this job, but my english is poor, so I can't do it :( 2010/5/18 Alan DeKok

RE: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Ramm-Ericson, Johannes
Hi, I'd definitely be willing to help out with this task. Particularly if it could be turned into a collaborative effort. Money is nice, however my primary motive would actually be to contribute to an outstanding piece of software that has been essential in my job. So, should I become

RE: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Jack Martin
To: 'freeradius-users@lists.freeradius.org' freeradius-users@lists.freeradius.org Subject: RE: Looking for an editor for FreeRADIUS documentation Hi, I'd definitely be willing to help out with this task. Particularly if it could be turned into a collaborative effort. Money is nice, however my

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Michael Schwartzkopff
Am Dienstag, 18. Mai 2010 09:16:06 schrieb Alan DeKok: In the interest of making the project better, we're looking for an editor for the documentation. The existing documentation is an ad hoc collection of files thrown together over a decade of effort, and written by many different people.

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Nyamul Hassan
I can both write chapters, and also edit the work of other contributors who are not too well versed in English. I would still request Alan to reconsider the wiki approach. Perhaps, you can dictate the structure of the wiki, and we can all contribute to fill up the contents. But, whatever the

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Arran Cudbard-Bell
AM To: 'freeradius-users@lists.freeradius.org' freeradius-users@lists.freeradius.org Subject: RE: Looking for an editor for FreeRADIUS documentation Hi, I'd definitely be willing to help out with this task. Particularly if it could be turned into a collaborative effort. Money is nice

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Alan DeKok
Arran Cudbard-Bell wrote: The problem with volunteer 're-factoring' work, is that although people mean well when they offer their assistance, it doesn't usually work out... They'll often spend a couple of weeks working on the task, get bored, figure they'll take a break and come back to it

Re: Looking for an editor for FreeRADIUS documentation

2010-05-18 Thread Fajar A. Nugraha
On Wed, May 19, 2010 at 3:12 AM, Alan DeKok al...@deployingradius.com wrote:  Personally, I'd be happy if this effort results in the existing docs being converted to RST.  It's easy to read as text, and looks good as HTML. The enthusiasm seems big enough. So how would this work? Get some people