Skip to contentSkip to conversation

wiki.linux-nfs.org

DISCUSSION Bernd Schubert 3 participants 11 messages Feb 25, 2006 – Feb 28, 2006

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

Hi,

I would like to add the complete FAQ on http://nfs.sourceforge.net to the wiki.linux-nfs.org site. Does somebody has objections against that? This will make it much easier to add new chapters like NFS-failover and others.

In order to do that, I think it would be best to modify the frontpage of the Wiki to have in the general field an entry "End user documentation for NFSv3" and rename the present "End user documentation" to "End user documentation for NFSv4". Unfortunately even when I'm logged in, I can't modify the frontpage. Could somebody with the proper permissions do that?

Thanks,
Bernd

Signature · 5 lines
Bernd Schubert
PCI / Theoretische Chemie
Universität Heidelberg
INF 229
69120 Heidelberg

_______________________________________________
NFSv4 mailing list
[email protected]
http://linux-nfs.org/cgi-bin/mailman/listinfo/nfsv4

#1 lore raw
Quoted 11 lines · Bernd Schubert

Hi,

I would like to add the complete FAQ on http://nfs.sourceforge.net to the wiki.linux-nfs.org site. Does somebody has objections against that? This will make it much easier to add new chapters like NFS-failover and others.

In order to do that, I think it would be best to modify the frontpage of the Wiki to have in the general field an entry "End user documentation for NFSv3" and rename the present "End user documentation" to "End user documentation for NFSv4". Unfortunately even when I'm logged in, I can't modify the frontpage. Could somebody with the proper permissions do that?

Hi Bernd,

Sounds like great ideas. I've unlocked the page so you should not have trouble editing it. We'd locked it because of spam issues, so please keep an eye on the change log for weird edits. When you're finished, or if the spam becomes a significant problem let me know and I'll relock it.

Bryce

#2 lore raw
Quoted 4 lines · Bryce Harrington
Quoted 3 lines · Bernd Schubert

Hi,

I would like to add the complete FAQ on http://nfs.sourceforge.net to t=

he

Quoted 9 lines
Quoted 9 lines

wiki.linux-nfs.org site. Does somebody has objections against that? This will make it much easier to add new chapters like NFS-failover and others.

In order to do that, I think it would be best to modify the frontpage of the Wiki to have in the general field an entry "End user documentation for NFSv3" and rename the present "End user documentation" to "End user documentation for NFSv4". Unfortunately even when I'm logged in, I can't modify the frontpage. Could somebody with the proper permissions do tha=

t?

Quoted 8 lines

Hi Bernd,

Sounds like great ideas. I've unlocked the page so you should not have trouble editing it. We'd locked it because of spam issues, so please keep an eye on the change log for weird edits. When you're finished, or if the spam becomes a significant problem let me know and I'll relock it.

Hello Bryce,

I just finished to the initial (automatic) transfer of the FAQ, there's sti= ll=20
a lot to improve, but this will have to wait until tomorrow.=20 So you may lock the frontpage again.

Cheers,
Bernd

PS: Sorry that I didn't create changelog entries for all pages, I just forg= ot=20
it at the beginning.

=2D-=20
Bernd Schubert
PCI / Theoretische Chemie
Universit=E4t Heidelberg
INF 229
69120 Heidelberg

#3 lore raw
Quoted 5 lines · Bernd Schubert

Hello Bryce,

I just finished to the initial (automatic) transfer of the FAQ, there's still a lot to improve, but this will have to wait until tomorrow.
So you may lock the frontpage again.

Actually I'll just leave it unlocked for the time being.

Quoted 5 lines

Cheers,
Bernd

PS: Sorry that I didn't create changelog entries for all pages, I just forgot it at the beginning.

Don't worry about it, I rarely do the changelog entries either. :-)

Bryce

#4 lore raw
In reply to Bernd Schubert
Quoted 1 line · Bernd Schubert

I would like to add the complete FAQ on http://nfs.sourceforge.net to the wiki.linux-nfs.org site. Does somebody has objections against that? This will make it much easier to add new chapters like NFS-failover and others.

if i update the FAQ on sourceforge, how do you get the updates? if you update your copy of the FAQ, how are the updates going to get back to the sourceforge copy?

by adding the FAQ to the wiki, are you proposing that it should be removed from sourceforge, and maintained by whomever wants to edit the wiki pages? i'm not really comfortable with that. the FAQ is very very carefully crafted and vetted so that it contains good information.

are you talking about both the FAQ and the How-To, or just one of them?

begin:vcard
fn:Chuck Lever
n:Lever;Charles
org:Network Appliance, Incorporated;Open Source NFS Client Development
adr:535 West William Street, Suite 3100;;Center for Information Technology Integration;Ann Arbor;MI;48103-4943;USA email;internet:[email protected]
title:Member of Technical Staff
tel;work:+1 734 763-4415
tel;fax:+1 734 763 4434
tel;home:+1 734 668-1089
x-mozilla-html:FALSE
url:http://troy.citi.umich.edu/u/cel/
version:2.1
end:vcard

_______________________________________________
NFSv4 mailing list
[email protected]
http://linux-nfs.org/cgi-bin/mailman/listinfo/nfsv4

#5 lore raw
Quoted 6 lines · Chuck Lever
Quoted 4 lines · Bernd Schubert

I would like to add the complete FAQ on http://nfs.sourceforge.net to the wiki.linux-nfs.org site. Does somebody has objections against that? This will make it much easier to add new chapters like NFS-failover and others.

Quoted 7 lines

if i update the FAQ on sourceforge, how do you get the updates? if you update your copy of the FAQ, how are the updates going to get back to the sourceforge copy?

by adding the FAQ to the wiki, are you proposing that it should be removed from sourceforge, and maintained by whomever wants to edit the

That was the idea, but thatswhy I also asked for objections.

Quoted 2 lines

wiki pages? i'm not really comfortable with that. the FAQ is very very carefully crafted and vetted so that it contains good information.

Well, thats the general problem of a wiki. Usually it works, but sometimes there is vandalism. On the other hand, most pages of the NFSv4 stuff also can be edited by all.
Maybe we should add a page where people wanting to modify the wiki can enter their username and email and Bryce can unlock them on request? (I hope this is possible with mediawiki, we unlock per user with moinmoin).

Quoted 2 lines

are you talking about both the FAQ and the How-To, or just one of them?

Well, first the FAQ.

Cheers,
Bernd

Signature · 5 lines
Bernd Schubert
PCI / Theoretische Chemie
Universität Heidelberg
INF 229
69120 Heidelberg

_______________________________________________
NFSv4 mailing list
[email protected]
http://linux-nfs.org/cgi-bin/mailman/listinfo/nfsv4

#6 lore raw
Quoted 10 lines · Bernd Schubert
Quoted 2 lines · Chuck Lever

wiki pages? i'm not really comfortable with that. the FAQ is very very carefully crafted and vetted so that it contains good information.

Well, thats the general problem of a wiki. Usually it works, but sometimes there is vandalism. On the other hand, most pages of the NFSv4 stuff also can be edited by all.
Maybe we should add a page where people wanting to modify the wiki can enter their username and email and Bryce can unlock them on request? (I hope this is possible with mediawiki, we unlock per user with moinmoin).

Yes, it is possible to configure it this way. However, the spam measures I've turned on seem to be doing the job.

Regarding having the FAQ in wiki, I don't have a strong feeling; I've seen it done effectively both ways. Putting it in wiki does make it easier for more people to contribute to it (at least in theory), but as Chuck points out, having it published as a stand alone entity gives it more credibility.

Perhaps a compromise might be to use the wiki as a "commentary on the faq" rather than as the faq itself? This would allow you to add whatever notes you feel to be appropriate, and would benefit Chuck by providing him with source material and feedback for future versions of the FAQ?

In any case, however you guys resolve it, it's great seeing the wiki get some use! :-)

Bryce

#7 lore raw
Quoted 6 lines

Perhaps a compromise might be to use the wiki as a "commentary on the faq" rather than as the faq itself? This would allow you to add whatever notes you feel to be appropriate, and would benefit Chuck by providing him with source material and feedback for future versions of the FAQ?

This is also fine. I think I will remove the FAQ this evening and add a=20 section about failover.

=2D-=20
Bernd Schubert
PCI / Theoretische Chemie
Universit=E4t Heidelberg
INF 229
69120 Heidelberg

#8 lore raw
In reply to Bernd Schubert
Quoted 5 lines · Bernd Schubert
Quoted 2 lines

by adding the FAQ to the wiki, are you proposing that it should be removed from sourceforge, and maintained by whomever wants to edit the

That was the idea, but thatswhy I also asked for objections.

you posted your question at 9am (EST) on a non-workday, then you waited less than an hour before proceeding with the transfer. that's hardly "asking for objections."

also, why didn't you contact me about this first? i am the FAQ maintainer, after all. is there a problem you are trying to address? is there something missing in the FAQ? have i been slacking?

Quoted 5 lines
Quoted 2 lines

wiki pages? i'm not really comfortable with that. the FAQ is very very carefully crafted and vetted so that it contains good information.

Well, thats the general problem of a wiki. Usually it works, but sometimes there is vandalism. On the other hand, most pages of the NFSv4 stuff also can be edited by all. Maybe we should add a page where people wanting to modify the wiki can enter their username and email and Bryce can unlock them on request? (I hope this is possible with mediawiki, we unlock per user with moinmoin).

i think wikis are a great tool, but here's the problem.

if anyone (in the NFS community) can edit the FAQ, what stops people from adding erroneous advice, or even advice that opens a security hole or that could cause silent data corruption?

for example, what happens if someone comes along and sees the "async" export option on the server and says "oh wow! i can make my server 10x faster with this! i'm going to add something to the FAQ that encourages everyone to use the 'async' export option!"

or even worse, someone adds advice to export shares without root squashing because it makes accessing the data "so much easier", or misconfigure Kerberos, and on and on.

sure, you can back it out easily, because it's a wiki. but this all depends on us knowing the NFS implementation well enough, testing the advice, and being on top of the changes so we can quickly remove advice that is destructive.

basically, people trust that this information won't screw them. if we let anyone edit this page, it will become worthless information. you don't see the Linux kernel developed this way, and for exactly the same reasons.

i don't deny that the FAQ and How-To could use some help. but please, let's reasonably discuss why we want to do this first, and see if we can address those issues with what we have.

begin:vcard
fn:Chuck Lever
n:Lever;Charles
org:Network Appliance, Incorporated;Open Source NFS Client Development
adr:535 West William Street, Suite 3100;;Center for Information Technology Integration;Ann Arbor;MI;48103-4943;USA email;internet:[email protected]
title:Member of Technical Staff
tel;work:+1 734 763-4415
tel;fax:+1 734 763 4434
tel;home:+1 734 668-1089
x-mozilla-html:FALSE
url:http://troy.citi.umich.edu/u/cel/
version:2.1
end:vcard

_______________________________________________
NFSv4 mailing list
[email protected]
http://linux-nfs.org/cgi-bin/mailman/listinfo/nfsv4

#9 lore raw
Quoted 7 lines · Chuck Lever
Quoted 4 lines · Bernd Schubert
Quoted 2 lines

by adding the FAQ to the wiki, are you proposing that it should be removed from sourceforge, and maintained by whomever wants to edit the

That was the idea, but thatswhy I also asked for objections.

you posted your question at 9am (EST) on a non-workday, then you waited

Well, I'm working too much nowadays. Almost have forgotten that weekends ar= e=20
non-workdays ;)

Quoted 2 lines

less than an hour before proceeding with the transfer. that's hardly "asking for objections."

Sorry, the initial transfer was more or less just a test how well it works= =20
automatically.

Quoted 4 lines

also, why didn't you contact me about this first? i am the FAQ maintainer, after all. is there a problem you are trying to address? is there something missing in the FAQ? have i been slacking?

Sorry, clearly my fault. I was really unpolite, please excuse me.

Quoted 31 lines
Quoted 10 lines
Quoted 3 lines

wiki pages? i'm not really comfortable with that. the FAQ is very very carefully crafted and vetted so that it contains good information.

Well, thats the general problem of a wiki. Usually it works, but sometimes there is vandalism. On the other hand, most pages of the NFSv4 stuff also can be edited by all.
Maybe we should add a page where people wanting to modify the wiki can enter their username and email and Bryce can unlock them on request? (I hope this is possible with mediawiki, we unlock per user with moinmoin).

i think wikis are a great tool, but here's the problem.

if anyone (in the NFS community) can edit the FAQ, what stops people from adding erroneous advice, or even advice that opens a security hole or that could cause silent data corruption?

for example, what happens if someone comes along and sees the "async" export option on the server and says "oh wow! i can make my server 10x faster with this! i'm going to add something to the FAQ that encourages everyone to use the 'async' export option!"

or even worse, someone adds advice to export shares without root squashing because it makes accessing the data "so much easier", or misconfigure Kerberos, and on and on.

sure, you can back it out easily, because it's a wiki. but this all depends on us knowing the NFS implementation well enough, testing the advice, and being on top of the changes so we can quickly remove advice that is destructive.

Quoted 8 lines

basically, people trust that this information won't screw them. if we let anyone edit this page, it will become worthless information. you don't see the Linux kernel developed this way, and for exactly the same reasons.

i don't deny that the FAQ and How-To could use some help. but please, let's reasonably discuss why we want to do this first, and see if we can address those issues with what we have.

Actually, I just wanted to add a how-to about high-availibility, moving a n= fs=20
exported partition and more details about the fsid usage.
I have now removed the transferred FAQ, but I'm still planning to add some = ha=20
stuff there. It only too late now (midnight).

What do you think about naming the section in the Wiki 'User FAQ' and then = to=20
put a big disclaimer on that page, that shortly explains that this is not t= he=20
official howto?

Sorry again,
Bernd

=2D-=20
Bernd Schubert
PCI / Theoretische Chemie
Universit=E4t Heidelberg
INF 229
69120 Heidelberg

#10 lore raw
Quoted 6 lines · Bernd Schubert
Quoted 3 lines

also, why didn't you contact me about this first? i am the FAQ maintainer, after all. is there a problem you are trying to address? is there something missing in the FAQ? have i been slacking?

Sorry, clearly my fault. I was really unpolite, please excuse me.

accepted, thanks.

Quoted 4 lines

Actually, I just wanted to add a how-to about high-availibility, moving a nfs exported partition and more details about the fsid usage. I have now removed the transferred FAQ, but I'm still planning to add some ha stuff there. It only too late now (midnight).

What do you think about naming the section in the Wiki 'User FAQ' and then to put a big disclaimer on that page, that shortly explains that this is not the official howto?

those sound useful enough to add to the official FAQ and How-To. i'm happy to work with you on the FAQ components, but we need to find one of the How-To maintainers to help with the other parts.

it might be useful to host "requests for enhancements to the FAQ and How-To" somewhere like on the wiki. using the wiki to develop the contents of the FAQ and How-To, then copying them to the real documents when new entries have been reviewed, could be a good thing.

begin:vcard
fn:Chuck Lever
n:Lever;Chuck
org:Network Appliance, Incorporated;Open Source NFS Client Engineering email;internet:[email protected]
title:Member of Technical Staff
x-mozilla-html:FALSE
url:http://www.monkey.org/~cel
version:2.1
end:vcard

_______________________________________________
NFSv4 mailing list
[email protected]
http://linux-nfs.org/cgi-bin/mailman/listinfo/nfsv4