[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [ft-devel] GSoC Status update and complete API reference website
From: |
Werner LEMBERG |
Subject: |
Re: [ft-devel] GSoC Status update and complete API reference website |
Date: |
Sun, 24 Jun 2018 15:48:15 +0200 (CEST) |
> 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
- Re: [ft-devel] GSoC Status update and complete API reference website, (continued)
- Re: [ft-devel] GSoC Status update and complete API reference website, Alexei Podtelezhnikov, 2018/06/12
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/12
- Re: [ft-devel] GSoC Status update and complete API reference website, Alexei Podtelezhnikov, 2018/06/12
- Re: [ft-devel] GSoC Status update and complete API reference website, Werner LEMBERG, 2018/06/13
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/13
- Re: [ft-devel] GSoC Status update and complete API reference website, Werner LEMBERG, 2018/06/13
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/14
- Re: [ft-devel] GSoC Status update and complete API reference website, Werner LEMBERG, 2018/06/16
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/16
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/24
- Re: [ft-devel] GSoC Status update and complete API reference website,
Werner LEMBERG <=
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/24
- Re: [ft-devel] GSoC Status update and complete API reference website, Werner LEMBERG, 2018/06/25
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/25
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/25
- Re: [ft-devel] GSoC Status update and complete API reference website, Werner LEMBERG, 2018/06/26
- Re: [ft-devel] GSoC Status update and complete API reference website, Nikhil Ramakrishnan, 2018/06/26