I don't mind volunteering as editor as well.

I started the PGMFI.org wiki which now has over 500 topics of documentation.

I will have to say that if it gets unweildy, I'll have to pass the reins, but i'll give everyone a heads up long beforehand.

-=dave

----- Original Message ----- From: "Andre Reis" <[EMAIL PROTECTED]>
To: <[email protected]>
Sent: Friday, December 01, 2006 4:55 PM
Subject: Re: [OF-users] I didn't see this in the manual (maybeI didn't lookhard enough)


Hands up. I have experience as administrator (two years) of a Sourceforge project that was frequently on the top ten (reasonable activity); I might not have much time in my hands to do an extensive overhaul of the documentation, but I'll volunteer to keep an eye on things. I can also take care of trivial bug reports (dupes, et al), and spam.

I also agree that there should be, ideally, at least two person as wiki editors.

Regards,
Andre Reis

--

Andre Braga Reis (andrereis at mailsnare dot net)
PGP Key ID 0xEA6758D2 (RSA)
3443 69A2 F292 29FF BD2F  785A 3B4A 6344 EA67 58D2


Rafiu Fakunle wrote:
Andre Reis wrote:
> Would it not make sense to put your manual on a wiki so that when
> questions get raised on the forums and lists, instead of re-hashing
them
> out again and again, you can quickly update the wiki manual yourself,
I was also thinking on proposing the exact same thing. We have a strong community of skilled users here, so why not leverage it?

I'm all for that. Maybe we can get a show of hands of folks willing to contribute to the documentation effort.

The Openfiler manual is considerably outdated, moving it to a Wiki page would be a positive thing, IMHO. And since your Trac system is wiki-based, you (Rafiu) can easily keep an eye on changes (just to make sure no-one vandalises the page with false information).


I'd be happy to hand out accounts on the Openfiler trac wiki to anyone who's interested in putting down their openfiler-related thoughts. I'd however rather not like to have the responsibility of managing said wiki; so we'd need a wiki editor (or two) who don't mind doing the babysitting.


R.



dave johnson wrote:
Rafiu,

Would it not make sense to put your manual on a wiki so that when questions get raised on the forums and lists, instead of re-hashing them out again and again, you can quickly update the wiki manual yourself, then point the user to the relevant section with: just added a section explaining how to do this in the manual: <link>

You could even allow users to update it as well if you choose a wiki package that allows moderated public updates. And again, if you choose the right wiki package, freezing and exporting to a PDF or HTML shouldn't be a large undertaking for when those milestone ISO releases come around.

I've been using wiki-based documentation for every client project I've setup since 2001 and have found it to be the single most determining factor in sustained client self-sufficiency, especially when implementing complex systems. It's simplicity and instant-update capability is what gives it its power.

-=dave

----- Original Message ----- From: "Rafiu Fakunle" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Cc: <[email protected]>
Sent: Friday, December 01, 2006 7:10 AM
Subject: Re: [OF-users] I didn't see this in the manual (maybe I didn't lookhard enough)


Hi Joe,

Joe Landman wrote:
Hi Rafiu and OF team:

  I was setting up a new server last night using 2.2 and the Areca
driver disks.  I had made a mistake relative to OF, in that I did not
carve up our large disk into a smaller disk for OS and a large partition for users. Unfortunately I did not recognize this as a mistake until I
tried to create a new volume for users.

  If it is not prominent, it might be worth making it so.  Systems
builds should keep the OS on a separate physical disk from the services,
in the sense of carving up the raid into smaller portions.


I think we've got this recommended somewhere - but probably not prominently enough as you've pointed out.


Documentation really needs an overhaul. I'm expecting a new manual to be ready by Jan at the latest.



Cheerio,

R.
_______________________________________________
Openfiler-users mailing list
[email protected]
https://lists.openfiler.com/mailman/listinfo/openfiler-users


_______________________________________________
Openfiler-users mailing list
[email protected]
https://lists.openfiler.com/mailman/listinfo/openfiler-users
_______________________________________________
Openfiler-users mailing list
[email protected]
https://lists.openfiler.com/mailman/listinfo/openfiler-users

_______________________________________________
Openfiler-users mailing list
[email protected]
https://lists.openfiler.com/mailman/listinfo/openfiler-users


_______________________________________________
Openfiler-users mailing list
[email protected]
https://lists.openfiler.com/mailman/listinfo/openfiler-users

Reply via email to