Merge pull request #269 from UBC-DSCI/dev

Merge dev into master

Author: trevorcampbell

README.md

@@ -74,6 +74,11 @@ The same comments regarding passwords and `sudo` as above apply here.
 - make sure we have permission to use all external resources that we use
 - remove all references to "clicking on things" in the HTML version of the book (e.g. "click this link to ...")
 - When we introduce a new term, use `**bolding**` to typeset it (but only the first introduction of the term)
+- for symbols as part of the text, make sure you give them their full name and surround with parentheses so that they
+  don't "disappear" in the rest of the text. So for example, if I have a `,` in the text, I should do
+  something like  "here is some text about the comma (`,`)". Or for `<-`, we should do "something like this assignment operator (`<-`)".
+  There are likely exceptions to this rule though.
+- Book titles in the text should be typeset in italics (e.g. *R for Data Science*)
 
 #### Code blocks
 - Use the knitr label format `##-[name with only alphanumeric + hyphens]` where 
@@ -131,6 +136,7 @@ bookdown::gitbook:
 #### Tables
 - make sure all tables get capitalized labels ("Table \\@ref(blah)", not "table below" or "table above")
 - make sure all tables get captions
+- make sure the row + column spacing is reasonable
 
 #### Note boxes
 - note boxes should be typeset as quote boxes using `>` and start with **Note:**
@@ -149,7 +155,8 @@ bookdown::gitbook:
 - data frame (not dataframe)
 - data set (not dataset)
 - scatter plot (not scatterplot)
-- capitalize all initialisms and acronyms (URL not url, API not api, $K$-NN not $k$-nn)
+- bar plot (not bar chart)
+- capitalize all initialisms and acronyms (URL not url, API not api, K-NN not k-nn)
 - response variable (not target, output, label)
 - predictor variable (not explanatory, feature)
 - numerical variable (not quantitative variable)
@@ -176,8 +183,11 @@ These are absolute last steps when rendering the PDF output:
 - Look for and fix bad line breaks (e.g. with only one word on the next line, orphans, and widows)
 - Look for and fix bad line wraps in code and text
 - Look for and fix bad figure placement (falling off page, going over the side)
+- Look for and fix large whitespace sections where LaTeX doesn't want to break the next paragraph (usually `\allowdisplaybreaks` helps)
+- Fix incorrect indenting. LaTeX will indent for a new paragraph if there is an extra whitespace line, so these should be deleted if no paragraph break is desired.
 - Look for `??` in the PDF (broken refs)
 - Look in the index for near-duplicates, and merge if needed
+- Look for / fix raw LaTeX code (search for backslash and curly brace in the final PDF)
 - Make sure the 3D figures (and the text around them that refers to clicking and dragging) are properly modified for the PDF output
 - Make sure all markdown label-replaced URLs (of the form `[blah](url)`) will make 
   sense in the hardcopy book version (i.e. nothing like "click this"). Many links appear in the additional resources: make sure the 

clustering.Rmd

@@ -1,49 +1,49 @@
-landmass,size
-Africa,11506
-Antarctica,5500
-Asia,16988
-Australia,2968
-Axel Heiberg,16
-Baffin,184
-Banks,23
-Borneo,280
-Britain,84
-Celebes,73
-Celon,25
-Cuba,43
-Devon,21
-Ellesmere,82
-Europe,3745
-Greenland,840
-Hainan,13
-Hispaniola,30
-Hokkaido,30
-Honshu,89
-Iceland,40
-Ireland,33
-Java,49
-Kyushu,14
-Luzon,42
-Madagascar,227
-Melville,16
-Mindanao,36
-Moluccas,29
-New Britain,15
-New Guinea,306
-New Zealand (N),44
-New Zealand (S),58
-Newfoundland,43
-North America,9390
-Novaya Zemlya,32
-Prince of Wales,13
-Sakhalin,29
-South America,6795
-Southampton,16
-Spitsbergen,15
-Sumatra,183
-Taiwan,14
-Tasmania,26
-Tierra del Fuego,19
-Timor,13
-Vancouver,12
-Victoria,82
+landmass,size,landmass_type
+Africa,11506,Continent
+Antarctica,5500,Continent
+Asia,16988,Continent
+Australia,2968,Continent
+Axel Heiberg,16,Other
+Baffin,184,Other
+Banks,23,Other
+Borneo,280,Other
+Britain,84,Other
+Celebes,73,Other
+Celon,25,Other
+Cuba,43,Other
+Devon,21,Other
+Ellesmere,82,Other
+Europe,3745,Continent
+Greenland,840,Other
+Hainan,13,Other
+Hispaniola,30,Other
+Hokkaido,30,Other
+Honshu,89,Other
+Iceland,40,Other
+Ireland,33,Other
+Java,49,Other
+Kyushu,14,Other
+Luzon,42,Other
+Madagascar,227,Other
+Melville,16,Other
+Mindanao,36,Other
+Moluccas,29,Other
+New Britain,15,Other
+New Guinea,306,Other
+New Zealand (N),44,Other
+New Zealand (S),58,Other
+Newfoundland,43,Other
+North America,9390,Continent
+Novaya Zemlya,32,Other
+Prince of Wales,13,Other
+Sakhalin,29,Other
+South America,6795,Continent
+Southampton,16,Other
+Spitsbergen,15,Other
+Sumatra,183,Other
+Taiwan,14,Other
+Tasmania,26,Other
+Tierra del Fuego,19,Other
+Timor,13,Other
+Vancouver,12,Other
+Victoria,82,Other