On Sat, 2004-08-14 at 14:39, Mark Johnson wrote:
Tammy Fox wrote:
> Mark, since this is your idea, please share some more details about what
> you have in mind. How is it different from the existing guide?
It would be a very brief tutorial on how to configure emacs for
user-friendly DocBook XML editing. Naturally, I'd recommend that new
users make use of my psgmlx[1] package for the psgml setup. [May
have to do some tweaking to the package to provide the right stuff
in the "Insert DTD" menu. I'll look inot this. Karsten & I are
putting the package on Savannah 'real soon now'.]
> What problem does it solve?
Setting up emacsp/sgml, effectively, w/o having to do any setup.
Truly a quick start to setting up a DocBook authoring environment in
emacs. It's different from what's in the Docs guide in that psgmlx
does all the setup for you, and provides sgml/xml-mode color themes
as well. Put simply, it's aimed at newbie emacs users.
IMO, we should continue to focus on smaller, modular <articles>.
Internally at Red Hat, I push for all processes and how-to material for
the Engineering Docs team to be in the one Doc Guide. However, we don't
want the Fedora docs project Doc Guide to become a massive tome. This
is just an extension of the argument that we don't want too grow our
document set by making bigger books until we have a solid, experienced
team. Working on smaller books that snap together is much more feasible
and scalable.
For that reason, I'd suggest Mark do his doc as a stand-alone. It will
be easy enough to convert it to a <chapter> and include it in the Doc
Guide when we are ready to support even just that one guide more
completely.
Oh, FWIW, psgmlx works really well. I don't use the right-click insert
element, or many of the other fancy mouse tricks that Mark included and
that are perfect for new users. What I love is that the _awesome_ psgml
keybindings are available for XML. I understand that nXML is probably
the way of the future (considering James Clark is behind it), but for
now psgmlx has a better feature set, IMHO.
- Karsten
--
Karsten Wade, RHCE, Tech Writer
a lemon is just a melon in disguise
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41