New "RTEMS Contributor Guide"

[Joel Sherrill]

On Nov 9, 2017 4:00 AM, "Sebastian Huber" <
sebastian.huber at embedded-brains.de> wrote:

On 09/11/17 05:48, Chris Johns wrote:

> On 08/11/2017 20:33, Sebastian Huber wrote:
>
>> Hello,
>>
>> I would like to merge the "RTEMS BSP and Driver Guide", the "RTEMS Porting
>> Guide", parts of the "RTEMS CPU Architecture Supplement", the
>> https://devel.rtems.org/wiki/Developer/Coding/Conventions  and the
>> https://devel.rtems.org/wiki/Developer/Release  into a new document
>> "RTEMS
>> Contributor Guide". The aim is to have a single document useful for RTEMS
>> contributors.
>>
>> Things like the coding standard should be moved to "RTEMS Software
> Engineering
> Standards". I said I would create this document but have not. I will try
> and do
> that this weekend.
>

What is the scope of this new manual? Why can't this be a chapter in a
manual containing everything of interest for a RTEMS developer/contributor
(not an application developer using RTEMS)?



> I am not sure about the other parts of the documents you refer too. I have
> not
> looked at them in detail to where they could go where. We have a User
> Manual and
> we will have a "RTEMS Software Engineering Standards" so do we need more
> documents or should be looking to reduce the number we have?
>

I think the documentation for RTEMS contributors is too scattered (and
horribly out of date, but this is another issue). It would be nice to have
one document that covers:

* Source code structure
* CPU architecture porting
* BSP development
* Driver development
* Coding standards
* Release engineering


That doesn't match any standard practices. You don't put process guides
with design information.

The first four may be ok in a single document. The second are software
engineering issues.



-- 
Sebastian Huber, embedded
<https://maps.google.com/?q=ber,+embedded&entry=gmail&source=g> 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.

_______________________________________________
devel mailing list
devel at rtems.org
http://lists.rtems.org/mailman/listinfo/devel
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20171109/9947a995/attachment-0001.html>