On Wed, 15 Jun 2011 13:19:06 +0200 Heiko Baums <lists@baums-on-web.de> wrote:
Am Wed, 15 Jun 2011 12:26:21 +0200 schrieb Dieter Plaetinck <dieter@plaetinck.be>:
In principle, this would be preferable, in practice I don't think it's possible because of various constraints. (see below)
Why not? Where's the difference between maintaining one "Official Install Guide" or one "Official Beginner's Guide"?
I never used the "Official Install Guide" because it's too confusing and has too little details, while the "Beginner's Guide" is far more detailed. So why not remove the "Official Install Guide" and maintain the "Beginner's Guide" officially?
beginners guide is very broad and is cumbersome / time consuming to maintain officially. * officially means releng has to approve, and devs in releng already have a huge time shortage, i don't want to spend my time approving and discussing tidbits of info outside my scope (i.e. the stuff found in the beginners guide). * as for cumbersome / time consuming, see next point
It's really not this simple. If you put everything in one guide, that means many more contributions will need to go through git, which is not desirable (because it's less convenient)
Less convenient for whom?
for anyone who tries to contribute. the git workflow just is more cumbersome (you need to fork, fix, make a patch and mail it, or publish code, do a pull request, etc)
I don't think we link to the beginners guide from anywhere. If we do, let me know.
It's on the homepage of the wiki. And it definitely should stay there.
and it accurately describes both the beginners guide and the official install guide. if users still find it confusing, maybe we could expand the accompanying text a bit more.
would be forced to read the more confusing explanations of the "Official Install Guide".
well, contributions are welcome...