Thanks Thomas.

On 03/13/2013 09:36 AM, Thomas Lange wrote:
On Tue, 12 Mar 2013 14:41:16 -0400, George VerDuin <gfv2008-h...@yahoo.com> 
said:
     >   * Is is safe to re-run fai-setup without re-installing from scratch?  
Under what circumstances is it required to run
     >     fai-setup again?  How do I reconcile a statements in existing documentation 
"Run fai-setup only once" and "after
     >     ??? run fai-setup" (exact sources not remembered).
Normally you run fai-setup once, and after that you run
fai-make-nfsroot if you changed something in /etc/fai.
Now that I have been engaged in FAI for a short time, your answer makes perfect sense technically. IMO it does presume that the first (only?) fai-setup was successful and a change to /etc/fai was for new user criteria. Further, the answer may not go deep enough when fai-setup aborts.

But let's stop that thread and step back to review this transaction as it relates to documentation...

Here in the reflector we have gone thru a a partial Q&A exchange. For those of us paying attention to the ebb and flow in mail it satisfies our needs. For those absent from the conversation it presents a google-like challenge to find the same kernel of knowledge, while at the same time the source of the question has not changed. Because the documentation has not changed, the potential of repeating the question remains. Now consider the observation of others that FAI has a steep learning curve. Steep? True or false doesn't matter so much as does presentation.

My argument in favor of wiki as a tool centers on this exchange we just had. If I had searched wiki for the exact source of my confusion and I developed a change you agreed satisfied my question, then all who follow us benefit from our work. Less google. Better(?) document set. Work to change happens mostly here on my IP not on your IP. Perhaps not much different from a script change to fai-setup? IMHO the approach describes a win-win. And -- this does not work well for documents published like books...



     > For my own part I will gladly contribute my success story soon
     > as I find one.
That would be very nice. We need more contributions for improving the 
documentation.
OK, but the untested part of my argument rests with the user community. If a user speaks bash and perl fluently, then fai-setup can be self-documenting and it is unfair to ask for duplicate knowledge in any other published document. In fact, duplication is counter productive, and a negative score from a quality viewpoint. Under these conditions, nubies just need to understand the tools they need to bring to the table.

Cheers
Geo

Antwort per Email an