[EMAIL PROTECTED] (Erik van der Poel) wrote:
>Simon Montagu wrote:
>>
>> Documentation for Bidi Mozilla
>
>Hi Simon,
>
>This is a great start. I think it would be even better if you had a more
>gentle introduction. Perhaps the document could start with an
>explanation of what bidi is, and what the purpose of the document is
>(and the intended audience).
>
>Also near the beginning, it would be nice to have a very high level
>review of Mozilla's architecture, followed by a description of how bidi
>fits into this picture. I.e. talk about the parser, content model (DOM),
>frame model, view model, JavaScript calling DOM APIs, reflow vs
>incremental reflow, etc, followed by the bidi specifics.
>
>This would give the reviewers a good idea about how bidi fits into the
>system, where it gets called, how often it gets called, etc, so that
>they can look at it from the point of view of design, performance,
>footprint, modularity, etc.
>
>There are also some terms like "visual" that many readers would not
>understand, so you could either explain those terms as you use them for
>the first time, or have a glossary near the end.
>
>Thanks,
>
>Erik
>
Thank you for the constructive criticism. I'll get on to this.
Simon
