<html><head></head><body><div style="color:#000; background-color:#fff; font-family:Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:13px"><div id="yui_3_16_0_ym19_1_1534294908225_45224">Hello everyone,</div><div id="yui_3_16_0_ym19_1_1534294908225_45957"><br></div><div id="yui_3_16_0_ym19_1_1534294908225_45354">As mentioned previously, I would like to start making some edits and submissions to the project. I am going to start small because that is a good way to start for the first edit and because Paul appears to be a prolific editor. I can see in his fork that he is already addressing some of the issues I noted. If our changes/commits collide, I will learn some more about how to stay in sync with upstream while making changes at the same time. <br></div><div id="yui_3_16_0_ym19_1_1534294908225_45353"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_45352">The first edits I propose are to massage the TOC indentations and add section numbers. <br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_45351"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_45307">First, the TOC indentations. The major sections should not be indented. By major section I mean mainly the phases called out like Early Configuration, Smoke-test the SBC/HAT combination, Live-test the GPS and so on. The supporting sections should be indented to show they are part of a larger section. <br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_47724"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_47723">The second change I propose is to add section numbers. The idea is to let the reader know where they are in the process. It can also help to have a number to refer to when discussing a section. A user contacting the project might type "In reference to section 4d. Clockmaker...". Here is a sample TOC. It is a snippet from my cloned repo with asciidoc modifications applied, built and rendered in a browser.<br></div>1. Introduction<br id="yui_3_16_0_ym19_1_1534294908225_56630">2. Parts list<br id="yui_3_16_0_ym19_1_1534294908225_56631">3. Hardware assembly<br id="yui_3_16_0_ym19_1_1534294908225_56632"> 3a. Understanding the GPIO connector<br id="yui_3_16_0_ym19_1_1534294908225_56633">4. Configuration overview<br id="yui_3_16_0_ym19_1_1534294908225_56634"> 4a. Make a bootable SD<br id="yui_3_16_0_ym19_1_1534294908225_56635"> 4b. First boot<br id="yui_3_16_0_ym19_1_1534294908225_56636"> 4c. First ssh access<br id="yui_3_16_0_ym19_1_1534294908225_56637"> 4d. Clockmaker<br><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_50928"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_50929">I also added a heading just for the Hardware Assembly section. I thought it deserved its own major section. <br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_52765"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_52764">These are quite a few lines of changes but I think it is "all one thought, which is easier for (code) review". <br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_57215"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_55191">I look forward to your thoughts on the proposal. <br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_55190"><br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_55189">Thanks, <br></div><div dir="ltr" id="yui_3_16_0_ym19_1_1534294908225_55188">Mike <br></div></div></body></html>