Re: [ft-devel] GSoC Status update and complete API reference website

[Werner LEMBERG]

> I have written a draft for this document, available at
> 
> https://github.com/nikramakrishnan/freetype-docs/wiki/Documentation-Guidelines-for-The-FreeType-Project

Very nice, thanks!

Some issues.

* s/comfig/config/.

* I'm not happy with

    To continue a list over multiple paragraphs, start the paragraphs
    with a tilde (~) character.

  I would rather prefer that a continuation is indented as before.
  Example:

    1. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
       Aliquam hendrerit mi posuere lectus.  Vestibulum enim wisi,
       viverra nec, fringilla in, laoreet vitae, risus.

       Donec sit amet nisl.  Aliquam semper ipsum sit amet velit.
       Suspendisse id sem consectetuer libero luctus adipiscing.

  [IIRC, Pandoc supports this style.]  Is this possible?  What do you
  think?

* Shall we mention that we prefer two spaces after a full stop ending
  a sentence?  Ditto for details on uppercasing in section titles (US
  style, for example `This and That'), how to cite a C function
  (without trailing parentheses), etc., etc.


    Werner