-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
David E. Wheeler wrote:
> I think that all pages that seem to document particular features
> should cross-reference the reference pages in section VI, but not
> necessarily vice-versa. I don't think that's asking for a lot. If
> you're reading the narrative section, um, narratively, then you'll
> see lots of "Look here for more on this topic when you're ready,"
> and that will be much more useful for the search-result-hit readers,
> too.
>
That is my idea too... every non-cannonical (ie. non section VI) page
links to relevant section VI (mostly the SELECT one, if I am not
mistaken). No need to link from VI to non-VI or from VI to VI.
> For myself, I've always used the reference documentation, and kind
> of never really understood where some of the extra documentation of
> certain features, like LIMIT/OFFSET, lived. I never realized there
> was a narrative section. As a technically-minded geek, I go right to
> the reference, and the other stuff is kind of a weird bonus that
> comes up when I do a search.
I have the same experience, I also go directly for the most technical
parts. But even I sometimes search and hit those narrative ones....
Btw. there seems to be no section VI (i.e. non-narrative) page about
datatypes and functions... things there link to section II.
>
> So unless you're reading the documentation like a bound book, or had
> glanced through each of the top-level pages of the TOC to
> familiarize yourself with the structure, I'm not sure anyone would
> really understand how the non-reference documentation was organized,
> or that it wasn't meant to be authoritative.
I for sure haven't, and I use the docs almost daily and I never read
that passage about novice users before today.... simply because my
"intro-filler-text filter" had made me skip the text every time I
visited section II.
/Svenne
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iEYEARECAAYFAkmJ2MoACgkQPPDUIBpvWQsMJACdGLdMirV/WjrzbF8ZLlHAqxoI
5nkAnRFnoaqDnrjzMtzkr7p7gUepEfzF
=4Z0b
-----END PGP SIGNATURE-----
