Wiki - once upon a time there was documentation
Hi to all, what happened to the contents of the wiki? A lot of stuff is missing, for example http://wiki.freeradius.org/Operators now has nothing more than a few badly explained examples and the table of the operators is missing. Also I couldn't find a lot of stuff that I'm sure there was on the wiki. Also searching stuff is now a pain. Is the old version still accessible in some way? Thanks to all, Denis -- \ __ __ _ * _\ \__\ \ \ _\ \/ \_\ \__ \ \ \__ \\ -------------------------> Registered Linux User # 372295 -----BEGIN GEEK CODE BLOCK----- Version: 3.1 GCS/CM d--- s:+: a-- C+++ UL+++S E--- W+(-) N o+ w--- O? M-- PS+ PE Y+ PGP t+(++) 5? X- R* tv-- b+ DI+ D++++ G+ e h! r++ y* ------END GEEK CODE BLOCK------
On 01/06/11 10:28, den2k wrote:
Hi to all, what happened to the contents of the wiki? A lot of stuff is missing, for example http://wiki.freeradius.org/Operators now has nothing more than a few badly explained examples and the table of the operators is missing. Also I couldn't find a lot of stuff that I'm sure there was on
Example?
the wiki. Also searching stuff is now a pain.
Be more specific. How is searching a pain?
2011/6/1 Phil Mayers <p.mayers@imperial.ac.uk>
On 01/06/11 10:28, den2k wrote:
Hi to all, what happened to the contents of the wiki? A lot of stuff is missing, for example http://wiki.freeradius.org/Operators now has nothing more than a few badly explained examples and the table of the operators is missing. Also I couldn't find a lot of stuff that I'm sure there was on
Example?
Right now the operators one. Also users and huntgroups were better descripted before, now there is just some brief introduction and nothing more. It was the lack of any explanation that I was referring to as lack of material (I'm not an English native-speaker so I make some mistakes).
Be more specific. How is searching a pain?
The entire resultset is now organized under a hierarchy of links that does not allow to see nor a snippet of the page nor to know which documents it exactly points, thus forcing the user to open a huge amount of tabs to only get handful of tabs pointing to the same document.
- List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html
-- \ __ __ _ * _\ \__\ \ \ _\ \/ \_\ \__ \ \ \__ \\ -------------------------> Registered Linux User # 372295 -----BEGIN GEEK CODE BLOCK----- Version: 3.1 GCS/CM d--- s:+: a-- C+++ UL+++S E--- W+(-) N o+ w--- O? M-- PS+ PE Y+ PGP t+(++) 5? X- R* tv-- b+ DI+ D++++ G+ e h! r++ y* ------END GEEK CODE BLOCK------
On 01/06/11 10:57, den2k wrote:
Example?
Right now the operators one. Also users and huntgroups were better descripted before, now there is just some brief introduction and nothing more. It was the lack of any explanation that I was referring to as lack of material (I'm not an English native-speaker so I make some mistakes).
The wiki was recently migrated onto a new platform, and the idea is that it will be easier to update, and easier to include the resulting docs with the server. This was discussed on the list - see the thread: New FreeRADIUS wiki - Help appreciated! ...in which the migration technique was discussed, and help was requested to reformat documents which had not migrated seamlessly.
On 01/06/11 11:17, Phil Mayers wrote:
On 01/06/11 10:57, den2k wrote:
Example?
Right now the operators one. Also users and huntgroups were better descripted before, now there is just some brief introduction and nothing more. It was the lack of any explanation that I was referring to as lack of material (I'm not an English native-speaker so I make some mistakes).
The wiki was recently migrated onto a new platform, and the idea is that it will be easier to update, and easier to include the resulting docs with the server.
This was discussed on the list - see the thread:
New FreeRADIUS wiki - Help appreciated!
...in which the migration technique was discussed, and help was requested to reformat documents which had not migrated seamlessly.
FWIW, it does look like the content is there in the "Operators" page, but it's one of the ones that didn't migrate and need fixing. Unfortunately I can't edit at the moment because I'm getting HTTP 500 errors when I try to login.
On 2011/06/01 12:17 PM, Phil Mayers wrote:
...in which the migration technique was discussed, and help was requested to reformat documents which had not migrated seamlessly. -
Is the old wiki accessable anywhere so one can help to manually transfer info? -- Johan Meiring Cape PC Services CC Tel: (021) 883-8271 Fax: (021) 886-7782 -------------------- Before acting on this email or opening any attachments you should read Cape PC Service's email disclaimer at: http://www.pcservices.co.za/disclaimer.html
On 01/06/11 11:54, Johan Meiring wrote:
On 2011/06/01 12:17 PM, Phil Mayers wrote:
...in which the migration technique was discussed, and help was requested to reformat documents which had not migrated seamlessly. -
Is the old wiki accessable anywhere so one can help to manually transfer info?
I suggest reading the detailed posts that Arran made. tl;dr version: As far as I know, all the old content is in the new wiki. However, some of it might no render correctly. If this is the case, login, hit edit, and fix it.
Johan Meiring wrote:
Is the old wiki accessable anywhere so one can help to manually transfer info?
$ git clone git://wiki.freeradius.org/wiki.freeradius.org.git That gets you *all* of the content. You can't push changes, but you can paste the results into the "edit" page. Alan DeKok.
den2k wrote:
Right now the operators one. Also users and huntgroups were better descripted before, now there is just some brief introduction and nothing more. It was the lack of any explanation that I was referring to as lack of material (I'm not an English native-speaker so I make some mistakes).
All of that documentation was taken from the "doc" directory, and "man" pages for those files.
The entire resultset is now organized under a hierarchy of links that does not allow to see nor a snippet of the page nor to know which documents it exactly points, thus forcing the user to open a huge amount of tabs to only get handful of tabs pointing to the same document.
Feel free to contribute changes which re-organize the wiki. Alan DeKok.
den2k wrote:
what happened to the contents of the wiki? A lot of stuff is missing, for example http://wiki.freeradius.org/Operators now has nothing more than a few badly explained examples and the table of the operators is missing.
Click on the "edit" link. The content is still there, it is just not being rendered correctly. And the operators are *also* documented in the "doc" directory, and in the "man users" page. Honestly, what more do you want? The content served to you on a silver tray?
Also I couldn't find a lot of stuff that I'm sure there was on the wiki. Also searching stuff is now a pain.
Feel free to contribute *something* which makes the wiki better.
Is the old version still accessible in some way?
All of the old content is still on the new Wiki. Alan DeKok.
2011/6/1 Alan DeKok <aland@deployingradius.com>
den2k wrote:
what happened to the contents of the wiki? A lot of stuff is missing, for example http://wiki.freeradius.org/Operators now has nothing more than a few badly explained examples and the table of the operators is missing.
Click on the "edit" link. The content is still there, it is just not being rendered correctly.
Thank you all.
And the operators are *also* documented in the "doc" directory, and in the "man users" page. Honestly, what more do you want? The content served to you on a silver tray?
With sugar, please :)
Also I couldn't find a lot of stuff that I'm sure there was on the wiki. Also searching stuff is now a pain.
Feel free to contribute *something* which makes the wiki better.
I will probably do, after finishing the project and the dissertation which I'm working on. -- \ __ __ _ * _\ \__\ \ \ _\ \/ \_\ \__ \ \ \__ \\ -------------------------> Registered Linux User # 372295 -----BEGIN GEEK CODE BLOCK----- Version: 3.1 GCS/CM d--- s:+: a-- C+++ UL+++S E--- W+(-) N o+ w--- O? M-- PS+ PE Y+ PGP t+(++) 5? X- R* tv-- b+ DI+ D++++ G+ e h! r++ y* ------END GEEK CODE BLOCK------
Hi, I've been updating some of the wiki pages to fix the formatting, etc. Arran put together a list of pages that were a priority at http://wiki.freeradius.org/New-Wiki. Are there other pages that people wish to have done next? (I'll try to fix the Operators page tonight. I fixed the http://wiki.freeradius.org/Policy.conf yesterday.) Thanks. -John On 06/01/2011 06:50 AM, den2k wrote:
2011/6/1 Alan DeKok <aland@deployingradius.com <mailto:aland@deployingradius.com>>
den2k wrote: > what happened to the contents of the wiki? A lot of stuff is missing, > for example http://wiki.freeradius.org/Operators now has nothing more > than a few badly explained examples and the table of the operators is > missing.
Click on the "edit" link. The content is still there, it is just not being rendered correctly.
Thank you all.
And the operators are *also* documented in the "doc" directory, and in the "man users" page. Honestly, what more do you want? The content served to you on a silver tray?
With sugar, please :)
> Also I couldn't find a lot of stuff that I'm sure there was on > the wiki. Also searching stuff is now a pain.
Feel free to contribute *something* which makes the wiki better.
I will probably do, after finishing the project and the dissertation which I'm working on. -- \ __ __ _ * _\ \__\ \ \ _\ \/ \_\ \__ \ \ \__ \\ ------------------------->
Registered Linux User # 372295
-----BEGIN GEEK CODE BLOCK----- Version: 3.1
GCS/CM d--- s:+: a-- C+++ UL+++S E--- W+(-) N o+ w--- O? M-- PS+ PE Y+ PGP t+(++) 5? X- R* tv-- b+ DI+ D++++ G+ e h! r++ y* ------END GEEK CODE BLOCK------
-- John Center Villanova University
John, It's ok, I fixed it this morning. Thanks for your help with the other pages and your continued conversion efforts :) Cheers, Arran On Jun 1, 2011, at 5:51 AM, John Center wrote:
Hi,
I've been updating some of the wiki pages to fix the formatting, etc. Arran put together a list of pages that were a priority at http://wiki.freeradius.org/New-Wiki. Are there other pages that people wish to have done next? (I'll try to fix the Operators page tonight. I fixed the http://wiki.freeradius.org/Policy.conf yesterday.)
Thanks.
-John
On 06/01/2011 06:50 AM, den2k wrote:
2011/6/1 Alan DeKok <aland@deployingradius.com <mailto:aland@deployingradius.com>>
den2k wrote: > what happened to the contents of the wiki? A lot of stuff is missing, > for example http://wiki.freeradius.org/Operators now has nothing more > than a few badly explained examples and the table of the operators is > missing.
Click on the "edit" link. The content is still there, it is just not being rendered correctly.
Thank you all.
And the operators are *also* documented in the "doc" directory, and in the "man users" page. Honestly, what more do you want? The content served to you on a silver tray?
With sugar, please :)
> Also I couldn't find a lot of stuff that I'm sure there was on > the wiki. Also searching stuff is now a pain.
Feel free to contribute *something* which makes the wiki better.
I will probably do, after finishing the project and the dissertation which I'm working on. -- \ __ __ _ * _\ \__\ \ \ _\ \/ \_\ \__ \ \ \__ \\ ------------------------->
Registered Linux User # 372295
-----BEGIN GEEK CODE BLOCK----- Version: 3.1
GCS/CM d--- s:+: a-- C+++ UL+++S E--- W+(-) N o+ w--- O? M-- PS+ PE Y+ PGP t+(++) 5? X- R* tv-- b+ DI+ D++++ G+ e h! r++ y* ------END GEEK CODE BLOCK------
-- John Center Villanova University - List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html
Arran Cudbard-Bell RM-RF Limited - Security consultation and contracting VoIP: +1 916-436-1352 Cell: +44 7854041841
participants (6)
-
Alan DeKok -
Arran Cudbard-Bell -
den2k -
Johan Meiring -
John Center -
Phil Mayers