-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Tuesday 23 August 2005 17:09, Tommy Reynolds wrote: > Uttered Thomas Jones <admin@xxxxxxxxxxxxxxx>, spake thus: > > I have quickly built up a DTD Driver for the Docbook 4.2 release. This > > driver contains declarations for Fedora Core specific documentation. > > I am not in favor of this subsetting (even if it's a proper subset) > approach. What we have is already rigorously documented in several > books at Borders, Barnes & Noble, Books-A-Million, Amazon, et. al., > hope I didn't leave out your favorite; if I'd remembered it I would > have plugged it. > Very good point. That definitely would be a disadvantage. You got my favorite. ;) > An "approved subset" would be yet another learning level for newbies. > I'd much rather see our current Documentation Guide fully-fleshed out > with recommended (or at least tested) examples for the > monkey-see-monkey-document crowd. No slur intended, but it's really > much easier to bang out a DocBook document with minimal learning > curve by just looking at an example of what you want to do; no > "internalized learning" required. > Actually, being a subset and not a superset; there is less that a end-user would need to learn. Take for instance the following elements: sidebar synopsis bridgehead dedication sect[1-5] Are any of these, needed? I hadn't realized it but somewhere in the wiki ---- I don't remember where --- it is stated not to utilize the sect elements. It just so happens that as a habit/preference I don't use these elements anyways. However without a correct document model, all instances derived thusly can and may be utilizing irrelevant, unneeded, or unwanted content simply because they are a part of the original xml markup language. As one of the editors once stated offlist, I am one of the seemingly few people who likes XML Markup. So I tend to see the project from another angle. Whether that's good or bad I am not sure yet. ;) Thomas -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (GNU/Linux) iD8DBQFDC7XfoR5cE1e/kEIRAo24AJ9uxVpDGnLHp1YJaFjGhTxyHhKfRgCffBjH c4zltTHQbIhWWUTKCksbgn4= =DeVP -----END PGP SIGNATURE----- -- fedora-docs-list@xxxxxxxxxx To unsubscribe: http://www.redhat.com/mailman/listinfo/fedora-docs-list
