Bug 744 - Documentation page needs work
Summary: Documentation page needs work
Alias: None
Product: Samba Web
Classification: Unclassified
Component: content (show other bugs)
Version: unspecified
Hardware: Other other
: P3 normal
Target Milestone: ---
Assignee: John H Terpstra (mail address dead(
QA Contact:
URL: http://www.samba.org/samba/docs/
Depends on:
Reported: 2003-11-08 19:09 UTC by Andrew Bartlett
Modified: 2004-05-01 04:30 UTC (History)
1 user (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Andrew Bartlett 2003-11-08 19:09:44 UTC
The documenation page makes it hard for the average user to quickly find the
difference between official Samba Team documentation, and that provided by others.  

It also makes it hard to tell that the 'samba HOWTO collection' is a 500 page
monolith, but the 'samba authenticated gateway howto' is a simple text HOWTO.  

The 'generated 2002' under the howto collection links make it feel as if the
documenation is massivly out of date.

I suggest that the links to 'using samba' and the howto collection be broken up
into a in-line table of contents, with links to the individual chapters, like we
do for the individual manpages.  

To do this sensibly, the HOWTO collection needs to be automaticly geneated into
the multi-page version.
Comment 1 Andrew Bartlett 2004-05-01 04:30:21 UTC
Docs page looks much better now