On Sunday 02 December 2001 02:07 pm, Ian Clarke wrote: > On Sun, Dec 02, 2001 at 11:11:32AM -0800, tom longson wrote: > > Ian, have you considered paying someone to write documentation on > > the project? I think this could really help out new developers. > > It is a possibility, however I would rather foster a culture where > developers are writing documentation themselves. Give a man a fish > and he will eat for a day, teach him to fish and he will eat for a > lifetime...
The docs look too much like a developer wrote them. I could write better docs, but really I'm just good at writing in general; I know nothing of writing "End User (TM)" documentation. Regardless, someone with a clue should outline a clear & concise table of contents, with special attention paid to who the audience is. I'd take part in working on the "Idiot's Reference" version, since I feel Freenet is useful for anyone who cares about privacy and censorship, not just mp3 fanatics. Freenet has come a way since I heard about the 0.1 release from Slashdot; what turned me away initially was the lack of clear and concise instructions (im exaggerating a little, but the point is valid). -- Jay Oliveri "In the land of the blind, GnuPG ID: 0x5AA5DD54 the one-eyed man is king." _______________________________________________ Devl mailing list Devl at freenetproject.org http://lists.freenetproject.org/mailman/listinfo/devl
