On Wed, 15 Jun 2011 13:19:06 +0200 Heiko Baums <[email protected]> wrote:
> Am Wed, 15 Jun 2011 12:26:21 +0200 > schrieb Dieter Plaetinck <[email protected]>: > > > 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...
