question about documentation
Kai Blin
k.blin at gmx.net
Tue Oct 10 16:20:15 GMT 2000
Sitting at the campfire, Mike Brodbelt told:
> > Of course, this is only my personal opinion. :-)
> > Does anyone else feel that this is a valid point?
>
> Definitely. I'd be interested in helping with documentation, and YODL is
> something that puts me off. I would not dispute that it's not difficult
> to learn, but, nevertheless, it presents a barrier to entry. Given that
> I have only a finite amount of time, I need to choose how to spend it.
> Learning a documentation style that I will probably never use outside of
> Samba docs won't necessarily stop me from contributing, but I'll grumble
> :-). If the formats were the same as the LDP, then I'd begrudge the time
> spent far less, as the skills are far more applicable outside the
> confines of the Samba project.
So we take SGML??? Docbook DTD
> All the arguments that YODL is easy to learn are doubtless correct, but
> nevertheless, it *does* require time to learn it, and is less generally
> used. I'd personally be happier learning something that might be harder,
> if I knew that the skills would be more useful afterwards. It's
> doubtless easier to learn languages other than C, but everyone (in the
> free software world at least) is interested in C, because it's
> ubiquitous (among other reasons).
>
Yes, but what's the team's opinion to it?
Cheers,
Kai
--
Kai Blin, Sysop
University of Tuebingen
dept. of immunology
I love treason but hate a traitor.
-- Gaius Julius Caesar
More information about the samba-technical
mailing list