question about documentation

Kai Blin k.blin at
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?


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