Replacing the Wiki user documentation page

Andrew Bartlett abartlet at samba.org
Sun May 4 23:32:13 MDT 2014


On Mon, 2014-05-05 at 06:19 +0200, Marc Muehlfeld wrote:
> Am 05.05.2014 02:47, schrieb Jelmer Vernooij:
> >> what do you think about replacing the user documentation page
> >> (https://wiki.samba.org/index.php/Samba) with
> >> https://wiki.samba.org/index.php/HowTo_Guide?
> >
> > Do you mean replacing the first page with the contents of the second,
> > or rather replacing links to the first with links to the second?
> 
> Sorry if it wasn't clear.
> 
> I wanted to drop the complete /Samba page and link the /HowTo_Guide page 
> instead on all pages where /Samba was linked before.
> 
> 
> 
> > The name of the first page seems kind of nondescript to me, so I think
> > we should avoid it.
> 
> Yes. That's why I want to drop the /Samba page. Everything in that Wiki 
> is about Samba. :-)
> 
> In the past, that was the /Samba4 page, which was renamed last year to 
> avoid the "Samba4" name.
> 
> 
> 
>  > I'd support replacing the links to the
>  > documentation with links to /HowTo_Guide (or perhaps just /Howto?).
> 
> I think /HowTo is a bit to general. And it's not really a HowTo. It's a 
> kind of table of content.
> 
> Or what about /User_Documentation contrary to /Developer_Documentation?

That sounds good.  Getting it looking a bit more tidy (like the Samba
page does, despite it's poor name) and filling out the red links would
be the next steps, I hope you agree.

Andrew Bartlett

-- 
Andrew Bartlett
http://samba.org/~abartlet/
Authentication Developer, Samba Team  http://samba.org
Samba Developer, Catalyst IT          http://catalyst.net.nz/services/samba






More information about the samba-technical mailing list