Data Science Desktop Survival Guide by Graham Williams
Desktop Survival Project Home Preface Data Science Introducing R R Constructs R Tasks R Strings R Read, Write, and Create Data Template Data Exploration Data Wrangling Data Visualisation Statistics ML Template ML Scenarios ML Activities ML Applications ML Algorithms Cluster Analysis Decision Trees Computer Vision Graph Data Privacy Literate Data Science Coding with Style Resources Bibliography Index

CLICK HERE TO VISIT THE UPDATED SURVIVAL GUIDE

Layout

20200105

resume

Keep lines to less then 80 characters for easier reading and fitting on a printed page.

resume

Align curly braces so that an opening curly brace is on a line by itself. This is at odds with many style guides. My motivation is that the open and close curly braces belong to each other more so than the closing curly brace belonging to the keyword (while in the example). The extra white space helps to reduce code clutter. This style also makes it easier to comment out, for example, just the line containing the while and still have valid syntax. We tend not to need to foucs so much any more on reducing the number of lines in our code, as we had to with punch cards, so we can now avoid Egyptian brackets.

Preferred

while (blue_sky())
{
  open_the_windows()
  do_some_research()
}
retireForTheDay()

Alternative

while (blue_sky()) {
  open_the_windows()
  do_some_research()
}
retireForTheDay()

If a code block contains a single statement, then curly braces remain useful to emphasise the limit of the code block; however, some prefer to drop them.

Preferred

while (blue_sky())
{
  do_some_research()
}
retire_for_the_day()

Alternatives

while (blue_sky())
  do_some_research()
retire_for_the_day()

while (blue_sky()) do_some_research()
retire_for_the_day()