Re: [Docutils-develop] Transforms...?

On Sat, 06 Jul 2002 01:06:34 -0400 David Goodger
<go...@us...> wrote:

> Adam Chodorowski wrote:
> > Actually, I meant:
> > 
> > 'author':nodes.authors,
> > 'authors':nodes.authors
> >  
> > Basically, the idea is to remove the difference between plural and
> > singular for the use for the most part (only retain it where the
> > language fits).
> 
> I think it best to leave the distinction::
> 
>     :Authors: Kurt Vonnegut, Jr.
> 
> This would look like two names.  Using ":Author:" instead makes it
> clear.

Ah, yes, I see what you mean. However, you still have a problem with that name
if you have multiple authors, so there needs to be some solution for it
anyway. For example, one could only allow ";" as separator, although you might
argue that it looks ugly. But otherwise, "Kurt Vonnegut, Jr." would not be
able to participate in collaborations. :-)


[FAQ directive]

> >> However, a simple enumerated or bulleted list will do just fine for
> >> syntax. A directive could treat the list specially; e.g. the first
> >> paragraph could be treated as a question, the remainder as the
> >> answer (multiple answers could be represented by nested lists).
> > 
> > But with that aproach you have the same problem: you can only have
> > short questions!
> 
> No, the question paragraph could be as long as you like.

Yes, but you would not be able to have several paragraphs or other construct
(like a table), which *might* be useful to explain the question more (although
I agree that this is normally not the case for a FAQ).

> > Wouldn't it make more sense to use a bulleted list for the questions
> > and answers, and alternating between them (ie. the first bullet is a
> > question, the second the answer, the third the question, and so on)?
> 
> No, that would be too clumsy.

Why do you think that?

---
Adam Chodorowski <ad...@ch...>

Chapter 1
    The story so far:
    In the beginning the Universe was created. This has made a lot of
    people very angry and been widely regarded as a bad move.