A couple of DocBook style questions

Matthew East mdke at ubuntu.com
Mon Feb 13 14:11:54 UTC 2006


On Mon, 2006-02-13 at 09:12 +0000, Matthew East wrote:
> On Mon, 2006-02-13 at 01:06 -0800, Brian Burger wrote:
> > I've been hacking away at the layout of the Ubuntu Desktop Guide; it's
> > mostly coherent now (sytlistically, at least) but a couple of minor
> > things are bugging me.
> > 
> > With the <orderedlist>, could we get the numbers it creates made bold?
> > It would go better, I think, with the rather large bullet points that
> > <itemizedlist> creates.
> 
> I've been converting lists to "itemizedlist" wherever I happen to edit a
> section: I agree we should move to these, where appropriate.

Another style I think we should adopt: as discussed on irc earlier today
with Brian: the method of advising users to install packages is dodgy at
the moment. Instead of:

[quote]
* Add the X repository
* Install:
	Programming (universe) -> Bluefish
[/quote]

We'd like to do this:

[quote]
* Install <application>Bluefish</application> from the Multiverse
repository (see <xref linkend="add-applications"/>).
[/quote]

I'd also suggest that we use the <filename> tags around names of
repositories, because that makes them stand out a bit, in monospace,
which is nice I think.

As usual, voice any fierce objections here.

Matt
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060213/dc10c05e/attachment.pgp>


More information about the ubuntu-doc mailing list