Randy McMurchy wrote:
The more I think about it, the more I think it is a bad thing to
have a mention of 'user notes' before the entire set of instructions.
After all it is the BLFS book. Here are some random thoughts.
1. It takes the reader away from the 'real' instructions page.
I understand where you are coming from, but as a user, I have frequently
found myself following the instructions only to be *caught out* by notes
later on in the text that say things like "If you have libjpeg
installed, add the --with-jpeg switch to your configure command".
I know I should read the whole page first but how many people actually do?
2. It could sway the reader before he even has a chance to read
the 'real' instructions.
See above. If there are some useful pointers about architectures or
dependencies then I'd want to read them *before* getting to the
instructions.
3. It is distracting to have to start at one page, then move to
another, then *hopefully* remember to come back to the other one.
There is no *flow*.
I disagree. Most if not all of us use browsers like we breathe (without
thinking and naturally). It isn't a big deal to jump back and forth, or
just open that link in a new window or tab...
4. There could be some configuration item or whatever on the wiki
that conflicts with the BLFS instructions. So, they do the wiki
stuff, then *hopefully* come back to the BLFS page, and alas, see
that what they've done is now being told to do differently.
Fair point. But will it really be conflicting??? This is hypothetical.
5. I could think of more, but this is probably enough.
Ditto.
Hope this helps. LFS is great and the Wiki looks like a nice addition. I
hope I'm not being impertinent by replying but you did ask :-)
Alan
--
http://linuxfromscratch.org/mailman/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
