Mailinglist Archive: opensuse-project (441 mails)

[Patrick Shanahan <ptilopteri@xxxxxxxxx>]

* Carlos E. R. <carlos.e.r@xxxxxxxxxxxx> [03-13-09 08:47]:
> On Tuesday, 2009-03-10 at 18:24 -0000, Administrator wrote:
>
> > An alternative would be to create a simple and unified method 
> > documenting features that doesn't take up much time and effort for the 
> > developers - and preferably one that enhances the process of 
> > development.  The problem will be creating one that integrates well with 
> > the development environments so that, for example, it is simple to 
> > document parameters to programmes or input dialogue boxes, and this 
> > documentation travels through the development process with the code.
>
> That kind of "inline" documentation exists, some project use it. But that 
> is only good for other devs, not for users, and is no substitute for a 
> good quality documentation written as such by skilled people (like the 
> SuSE admin book is/was).

Yes, "There *is* no substitute for a good quality documentation
written as such by skilled people (like the SuSE admin book is/was)".

-- 
Patrick Shanahan         Plainfield, Indiana, USA        HOG # US1244711
http://wahoo.no-ip.org     Photo Album:  http://wahoo.no-ip.org/gallery2
Registered Linux User #207535                    @ http://counter.li.org
-- 
To unsubscribe, e-mail: opensuse-project+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-project+help@xxxxxxxxxxxx