Mailinglist Archive: opensuse (3513 mails)

[Matthew <matthew@xxxxxxxxxxxxxxx>]

Yep! So even if you cannot program this will help! Actually, I think we 
sometimes need more documentors rather than programmers :-).

Matt

On Wednesday 28 February 2001 06:40 pm, S.Toms wrote:
> On Wed, 28 Feb 2001, Matthew wrote:
>
> m> The documentation on a lot of stuff really sucks...Have you totally
> fixed m> your problem now? I only discovered I could not get mine to work
> becuase I m> had to set an encrypt password to the file.
> m>
> m> Its not the fault the of Linux, just I know the documentation could be a
> m> little better. Also, with Samba they have to deal with MS who really are
> m> trying to stop the Samba team from succeeding too much as Linux can
> replace m> an NT server...
> m>
>
>   In alot of cases, the developers get so busy wrting the program they
> forget to do the documentation, or neglect to mention certain things
> because they tend tobe more familiar with the program itself. So what they
> tend to think is common knowledge for a given command or program is a
> mystery to others who havn't messed with it at all.
>   In these cases, I like to write my own documentation, or modify the
> existing and forward it onto the developers for inclusing in the next
> release of whatever.
>   I would recommend this to everyone who thinks the documentation leaves
> alot to be desired, because without our help the documentation may not
> change in the next release because the developers are too busy making the
> programs better/faster/prettier/etc..  :)