Dokumentation (was: Föreläsning om Monotone)

[Richard Levitte]

In message <4D90FAFF.60700 at elmindreda.se> on Mon, 28 Mar 2011 23:17:51 +0200, Camilla Berglund <elmindreda at elmindreda.se> said:

elmindreda> Richard Levitte wrote:
elmindreda> > Det behövs en snabbutbildning i Kerberos och AFS...  det har i varje
elmindreda> > fall jag upplevt som den största tröskeln.
elmindreda> 
elmindreda> En grundkurs i Kerberos och AFS är en utmärkt idé, men
elmindreda> dokumentation av de rådande hacken (har för mig det t.ex.
elmindreda> involverade CVS, AFS, Kerberos och något hemmahackat
elmindreda> XSLT-system för att uppdatera en länk på hemsidan) har de
elmindreda> gångerna jag försökt hjälpa till varit ett större problem.

Jag håller väldigt mycket med om den saken...  och lite spridda README
duger inte, speciellt om de, som du säger, inte är uppdaterade.

Problemet är egentligen två...  dels tekniskt och dels socialt.  Det
tekniska problemet är, var och hur ska vi ha dokumentationen?  Det
andra handlar om att få lite pli hos oss själva, annars kan ingen
teknik i världen hjälpa oss.

-- 
Richard Levitte   \ Nordingrågatan 20  \ levitte at stacken.kth.se
                   \ S-162 53 VÄLLINGBY \ T: +46-708-26 53 44
                    \       SWEDEN       \
Procurator Odiosus Ex Infernis                -- poei at bofh.se
Member of the OpenSSL development team: http://www.openssl.org/
Member of the monotone development team: http://monotone.ca/

-----------------------------------------------------------------
A: Because it fouls the order in which people normally read text. 
Q: Why is top-posting such a bad thing? 
A: Top-posting. 
Q: What is the most annoying thing on usenet and in e-mail?