<div dir="ltr"><span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">Ok, I'll create the new section in CodingStyle. What about converting this file (CodingStyle) to markdown format?</span></div><div class="gmail_extra"><br><div class="gmail_quote">2018-04-09 16:44 GMT+02:00 Dirk Hohndel <span dir="ltr"><<a href="mailto:dirk@hohndel.org" target="_blank">dirk@hohndel.org</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word"><br><div><span class=""><blockquote type="cite"><div>On Apr 9, 2018, at 3:26 AM, Miika Turkia <<a href="mailto:miika.turkia@gmail.com" target="_blank">miika.turkia@gmail.com</a>> wrote:</div><div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><br></div><div>To cope with this I've prepared a change introducing a new CONVENTIONS.md file that is meant to collect such information: <a href="https://github.com/Subsurface-divelog/subsurface/pull/1196" target="_blank">https://github.co<wbr>m/Subsurface-divelog/subsurfac<wbr>e/pull/1196</a> Any feedback is welcome. Since it is the one convention I learned during a recent pull request I proposed, I started with documenting the use of membuffer for string manipulations...</div></div></blockquote><div><br></div><div>What is the distinction between the existing CodingStyle and the proposed CONVENTIONS.md? IMO, what you currently have there could have easily been included in the CodingStyle. Having all the essential information in single place sounds better for newcomers.<br></div></div></div></div></div></blockquote><div><br></div></span><div>I think I'll have to agree with Miika on this one. Fewer places to read through make it easier for people to find what they are looking for.</div><div>One could of course argue that using membuffer and other such conventions technically aren't coding style, but I think with a slightly more liberal interpretation of that term... simply add a section called "Conventions" to the CodingStyle document and I think we will all be happier :-)</div><span class=""><div><br></div><br><blockquote type="cite"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Then if/when the currently discussed pull request would be approved it would be nice to reflect these changes in the corresponding page on <span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"><a href="https://subsurface-divelog.org/" target="_blank">https://subsurface-divelog.<wbr>org</a>. The question is: Was this page manually edited in Subsurface-website repository or was it actually generated from markdown? If so, is the script available somewhere?</span></div><div><span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"><br></span></div></div></blockquote><div>IIRC these are edited directly.<br></div></div></div></div></blockquote></span></div><br><div>The website is run on a WordPress instance that is synced (in a somewhat fragile manner) with a GitHub repo. So the sources for the page in question should be here:</div><div><br></div><div><a href="https://github.com/Subsurface-divelog/Subsurface-website/blob/master/_pages/contributing.en" target="_blank">https://github.com/Subsurface-<wbr>divelog/Subsurface-website/<wbr>blob/master/_pages/<wbr>contributing.en</a></div><div><br></div><div>The translations of the website are unfortunately not as well maintained as one might hope (this is all volunteer work and it's tedious work...), but you can see the translations in the GitHub repo as well.</div><span class="HOEnZb"><font color="#888888"><div><br></div><div>/D</div></font></span></div></blockquote></div><br></div>