mlhim-owners team mailing list archive
-
mlhim-owners team
-
Mailing list archive
-
Message #00061
Re: Documentation
Hi Tim,
I understand the need for standardization. It is really important in OS
projects. Especially when you are dealing with our level of complexity here.
So, I am +1 for migrating to ODF and +1 for defining a template, but I
don't have any suggestion to give as far as which template to choose goes.
Cheers,
Luciana.
Em 18/02/2011 19:57, Tim Cook escreveu:
> On Fri, 2011-02-18 at 20:41 -0300, Luciana Tricai Cavalini wrote:
>> Aren't we trying to "make
>> things as simple as possible, but no simpler"? For me, template-free
>> ODFs are "make things as simple as possible, but no simpler", because
>> otherwise the alternative is having incomplete documentation, which is
>> the "simpler" situation.
>
> I appreciate your sentiment (I've heard that quote before somewhere).
>
> Here is my rational for asking for a template:
>
> ODF tables of contents & other tables of ... all use Styles to determine
> what goes into one and where.
>
> Styles also define which fonts are used which determines how layouts are
> viewed and how extracts are produced (PDFs, etc).
>
> Since the context in a Documentation ODF, is defined by the layout and
> there will (hopefully) by many different authors. I highly suggest that
> we define a template for all MLHIM documentation. It doesn't mean we
> can't change it if we need to but not having one will lead to a mess of
> different styles and types. This lack of consistency will be a detriment
> to comprehension in the future.
>
> --Tim
>
>
--
Esta mensagem foi verificada pelo sistema de antiv�s e
acredita-se estar livre de perigo.
References