[PATCH 2/2] doc: remove outdate Samba3-HOWTO
scott.lovenberg at gmail.com
Wed Apr 9 09:33:29 MDT 2014
On Tue, Apr 8, 2014 at 8:54 AM, Björn Jacke <bj at sernet.de> wrote:
> On 2014-04-06 at 21:44 +1200 Andrew Bartlett sent off:
> > The reason I asked for that, is that I don't think it's a chapter here
> > or there that is still good and current. Surprising as it seems, most
> > of what I've read tonight still looks reasonable, because we work hard
> > to keep our old configurations working.
> I disagree. There a some things which have even been wrong when the howto was
> written and there is a ton of stuff, which is wrong just because samba changed
> and the world kept spinning for 10 years. Even is you find that 70% or whatever
> is still correct the remaining 30% which are wrong break the users who rely on
> it their neck. Nobody is maintainig that old-world (non wiki) documentation.
> The only documentation which is maintained by people from the community and
> from the team is the Wiki.
> The only commits and "fixes" are those two or three deletions that come from
> someone who wants to find arguments not to delete this rotten (sorry, there is
> no other word for what it is) documentation. This is not helpful for anybody.
To your last point, that's not entirely true. I have a few patches in
the books because while looking something up I'd come across something
that was so terribly wrong that I felt the need to correct it fearing
that users would rely on the document's correctness. For instance,
how often on the mailing list do we see people with smb.confs where
they set socket options and tcp options, that drastically slow down
their server, because that used to be recommended? Then we hear
"Samba is slow".
I'm not advocating for wholesale deletion of these documents, but I
certainly don't have the spare time to do more than "drive by" patches
from time to time and they need a lot more work than that. I suspect
that these days everyone just goes to the wiki anyways. Plus, for me,
editing the wiki is much easier than patching the HOWTO and Using
Samba and fighting with git and its workflow (I still find myself from
time to time in a place where I can't commit or revert or rewind).
Peace and Blessings,
More information about the samba-technical