Fedora DTD?
Thomas Jones
admin at buddhalinux.com
Tue Aug 23 23:48:42 UTC 2005
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On Tuesday 23 August 2005 17:09, Tommy Reynolds wrote:
> Uttered Thomas Jones <admin at buddhalinux.com>, 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-----
More information about the fedora-docs-list
mailing list