<div dir="ltr"><div class="gmail_extra">I think examples are convincing, but ideally we would put most of them in separate document. </div><div class="gmail_extra"><br></div><div class="gmail_extra">Though I love reading about programming, I generally do it in a half-assed sort of way. Unless the writing is very blunt and clear, I don&#39;t really understand it until I need to do it myself. I doubt I&#39;m the only person here like this. <br></div><div class="gmail_extra"><br></div><div class="gmail_extra">I badly want this proposal to gain traction (more so every time I find myself writing code that it could improve, which happens daily). I think the proposal ought to be short and sweet. I believe if we hold the reader&#39;s attention just long enough for them to understand what we&#39;re talking about, they&#39;ll be onboard. Once they&#39;re hooked, we have our second document with the list of examples.</div><div class="gmail_extra"><br></div><div class="gmail_extra">It would also be great to have the &quot;before snippet&quot; and &quot;after snippet&quot; visually arranged side-by-side. I&#39;m guessing markdown doesn&#39;t support this :(</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div></div>