[Mallard] Add new element to lists which doesn't require a child block element
- From: Phil Bull <philbull gmail com>
- To: gnome-doc-list <gnome-doc-list gnome org>
- Subject: [Mallard] Add new element to lists which doesn't require a child block element
- Date: Sat, 12 Sep 2009 13:24:36 +0100
Hi guys,
Suggested alteration to the Mallard spec.
SUGGESTION
Mallard lists usually require the author to type
<item><p>Something</p></item> multiple times. Typing the same tags again
and again is tiresome. I propose a "shorthand" tag which behaves exactly
the same as <item><p>, but which is shorter and doesn't require two
tags, e.g. <li>Something</li>.
ADVANTAGES
(1) Faster to type, reduces burden on author.
(2) Reduces clutter, makes it easier to find errors or read the content
between tags.
(3) Reduced risk of forgetting to close tags, or nesting tags
improperly.
(4) The existing <item><block> formalism can still be used when block
elements other than <p> are required.
PROBLEMS
(1) Provides two ways of doing the same thing, could cause confusion.
(2) Not particularly elegant.
(3) More difficult for parsers to deal with?
(4) Panders to lazy people.
Thanks,
Phil
--
Phil Bull
https://launchpad.net/people/philbull
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]