samba - May 2014 - Replacing the Wiki user documentation page

Hello,

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?

The HowTo Guide is a table of content, we worked out in a past 
documentation team meeting. Everything from the current user 
documentation page is already link there and even more.

I know that currently there are many red (not existing) pages. But I 
think, it will make it easier for contributors, to see where we are 
missing documentation.

What do you think about replacing the page?

Regards,
Marc

On Sun, May 04, 2014 at 02:35:19PM +0200, Marc Muehlfeld
wrote:
> 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?

The name of the first page seems kind of nondescript to me, so I think
we should avoid it. I'd support replacing the links to the
documentation with links to /HowTo_Guide (or perhaps just /Howto?).

Cheers,

jelmer
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: Digital signature
URL:
<http://lists.samba.org/pipermail/samba/attachments/20140505/7bf4af5b/attachment.pgp>

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?



Regards,
Marc