On keeping the docs

[Andrew Bartlett]

On Fri, 2012-09-14 at 13:56 +0200, Michael Adam wrote:
> On 2012-09-14 at 12:10 +0200, Karolin Seeger wrote:
> > 
> > I like Andrew's proposal to let the docs in the git repo, but not to
> > include them in the Samba release tarballs. Would you agree on this?
> 
> Yes, this is the absolute minimum we should do.
> Shipping the outdated docs has caused so much confusion in the past.
> 
> I would even remove the sources or at least mark the docs as outdated.

> That being said, I think that it would be desirable to have
> up to date documentation like the howto and by-example docs
> in the reop. But I don't think that we will have it in a
> reasonable timeframe. And we do have vaguely up to date wiki docs.
> (And again I don't think that we should ship legacy docs in the
> hope that they will be updated sometime in the future.)

I'm using my jet-lag to walk over the docs and cull the clearly out of
date stuff.  Hopefully after that we can asses how much more needs to be
done. 

Andrew Bartlett

-- 
Andrew Bartlett                                http://samba.org/~abartlet/
Authentication Developer, Samba Team           http://samba.org