<div dir="auto"><div><br><div class="gmail_extra"><br><div class="gmail_quote">On Nov 9, 2017 4:00 AM, "Sebastian Huber" <<a href="mailto:sebastian.huber@embedded-brains.de">sebastian.huber@embedded-brains.de</a>> wrote:<br type="attribution"><blockquote class="quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="quoted-text">On 09/11/17 05:48, Chris Johns wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 08/11/2017 20:33, Sebastian Huber wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hello,<br>
<br>
I would like to merge the "RTEMS BSP and Driver Guide", the "RTEMS Porting<br>
Guide", parts of the "RTEMS CPU Architecture Supplement", the<br>
<a href="https://devel.rtems.org/wiki/Developer/Coding/Conventions" rel="noreferrer" target="_blank">https://devel.rtems.org/wiki/D<wbr>eveloper/Coding/Conventions</a>  and the<br>
<a href="https://devel.rtems.org/wiki/Developer/Release" rel="noreferrer" target="_blank">https://devel.rtems.org/wiki/D<wbr>eveloper/Release</a>  into a new document "RTEMS<br>
Contributor Guide". The aim is to have a single document useful for RTEMS<br>
contributors.<br>
<br>
</blockquote>
Things like the coding standard should be moved to "RTEMS Software Engineering<br>
Standards". I said I would create this document but have not. I will try and do<br>
that this weekend.<br>
</blockquote>
<br></div>
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)?<div class="quoted-text"><br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
I am not sure about the other parts of the documents you refer too. I have not<br>
looked at them in detail to where they could go where. We have a User Manual and<br>
we will have a "RTEMS Software Engineering Standards" so do we need more<br>
documents or should be looking to reduce the number we have?<br>
</blockquote>
<br></div>
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:<br>
<br>
* Source code structure<br>
* CPU architecture porting<br>
* BSP development<br>
* Driver development<br>
* Coding standards<br>
* Release engineering</blockquote></div></div></div><div dir="auto"><br></div><div dir="auto">That doesn't match any standard practices. You don't put process guides with design information.</div><div dir="auto"><br></div><div dir="auto">The first four may be ok in a single document. The second are software engineering issues. </div><div dir="auto"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="quoted-text"><br>
<br>
-- <br>
Sebastian Hu<a href="https://maps.google.com/?q=ber,+embedded&entry=gmail&source=g">ber, embedded</a> brains GmbH<br>
<br>
Address : Dornierstr. 4, D-82178 Puchheim, Germany<br>
Phone   : <a href="tel:%2B49%2089%20189%2047%2041-16" value="+4989189474116" target="_blank">+49 89 189 47 41-16</a><br>
Fax     : <a href="tel:%2B49%2089%20189%2047%2041-09" value="+4989189474109" target="_blank">+49 89 189 47 41-09</a><br>
E-Mail  : <a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brain<wbr>s.de</a><br>
PGP     : Public key available on request.<br>
<br>
Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.<br>
<br></div><div class="elided-text">
______________________________<wbr>_________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman<wbr>/listinfo/devel</a></div></blockquote></div><br></div></div></div>