On keeping the docs

Andrew Bartlett abartlet at samba.org
Fri Sep 14 23:26:07 MDT 2012

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

Andrew Bartlett

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

More information about the samba-technical mailing list