Docs Style Guide

[Sebastian Huber]

On 19/07/2019 00:23, Gedare Bloom wrote:
> On Thu, Jul 18, 2019 at 11:35 AM Chris Johns<chrisj at rtems.org>  wrote:
>> On 19/7/19 1:32 am, Gedare Bloom wrote:
>>> Reviewing the BB doc patch, I realized that we need a style guide for
>>> writing docs [1].
>> Thank you for raising this.
>>
>>> We should start to collect Documentation Style notes in a wiki page,
>>> and then push it to the docs [1]. If anyone has some initial set of
>>> thoughts, it would be good to put them down in reply to this email.
>> We do havehttps://git.rtems.org/rtems-docs/tree/README.txt#n393.
>>
> Would it be OK if we refactor the README to move some of this to the
> SwE document, and link/reference to it from the README?

I had this also on my TODO list, the Sphinx guide should move to the SwE 
and a reference to it should be added to the README.

-- 
Sebastian Huber, embedded brains GmbH

Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone   : +49 89 189 47 41-16
Fax     : +49 89 189 47 41-09
E-Mail  : sebastian.huber at embedded-brains.de
PGP     : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.