February 2016

04 Feb 16 0101

Software coder Eric Suh writes, in a piece entitled, Writing code and prose:

One of the most important qualities for effective programming in large codebases is good writing ability—not writing code, but writing prose for other humans.
 
Undoubtedly, this is not a surprise to long-time industry veterans (after all, we don't often program in machine code anymore), but it's a quality I often find is overlooked by engineers that arrive straight out of college. Those that I see write the cleanest, most maintainable code are those who write prose well, whether in documentation, in emails, or in their everyday lives.
 
Many aphorisms about writing style translate fairly well to coding. Consider the following selection of principles from The Elements of Style by Strunk and White:

________________

Query Thread Page

On this page you can:
 
  • subscribe to this query
    By subscribing, you will receive email (as frequently as you specify) of new activity in this query.
  • vote up or vote down queries and replies
    Voting is a generalized proxy for your assessment of the worth, quality, articulation, etc of a query or reply. Voting up a reply or query increases the reply/query author's mojo by one. After you vote, you have five minutes to undo it.
  • reply to the query or add a comment to the query or any reply
    A reply is a serious substantive response, worthy of addition to the knowledge being recorded for all of us here. Comments, simply, are for responses that are not replies (questions, clarifications, caveats, etc). You must scroll all the way down to add a reply; might as well read all of the replies on the way down. If you would like to include with your reply new legal text for others to edit, feel free to add a clause. Adding a reply gives you one mojo.
  • edit a clause (quick-reply)
    If you want to quickly add a reply that is an edit of another member's legal text, click the edit clause link on the clause you wish to edit, and you will be taken to the bottom of the page, with the text of the clause ready for your edits.
  • select best reply (if you are the author of the query)
    If you authored this query, be sure to select the reply that you believe is the best (and consider explaining why you selected this reply as best in a comment to that reply). You receive one mojo for doing so. The author of the reply you select as best will receive four mojo or the bounty award you posted for this query. You can change your mind as many times as you want. If you de-select a best reply, the reply author loses two mojo or the bounty mojo awarded, and you lose one mojo.
  • edit/update or delete query (if you are the query author)
    If you authored this query, you may edit it at any time, and delete it before a reply has been posted to it. Clauses may be edited only if no other member has redlined that clause. You may also add a bounty award or increase already-posted bounty, at any time (even after a reply has been posted).
  • flag (ie complain about) a query, reply or comment
    Use as sparingly as appropriate given the circumstances.
  • quiver and favorite
    You may add/remove this query to/from your favorites, and add/remove clauses in this query to/from your quiver. If you are a guild moderator, you can similarly add/remove this query to/from guild favorites, and add/remove clauses here to/from your guild quiver.

A friendly reminder: be excellent to each other and remember the human.

FAQs | How do I ...?
What are subscriptions?
Redline allows you to subscribe to queries (so that you can be alerted to new replies and comments that are posted to those queries), members (so that you can know of new queries posted by that member) and guilds (so that you can track new queries posted with tags of guilds you follow). With subscriptions, you are notified via email, and on the Home (Your Notifications) page, of new activity corresponding to your subscriptions. Via the Settings/Subscriptions page, you can manage your subscriptions, including altering the timing of notification emails.