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
done.
Andrew Bartlett
--
Andrew Bartlett http://samba.org/~abartlet/
Authentication Developer, Samba Team http://samba.org
More information about the samba-technical
mailing list