How to Read and Comment

last updated February 28, 2017

** TO DO: update section **

Data Visualization for All refers to both this open-access digital book and a free online course by the same name. We refer to them as “the book” and “the course.” TO DO: add link to course

Use a second monitor

If you have a small screen, consider connecting a second monitor, or work next to a second computer or tablet. This allows you to view tutorials in one screen and build visualizations in the other screen.

Image: Laptop with second monitor, and with tablet

Image: Laptop with second monitor, and with tablet

Refresh browser

To view the most up-to-date content in your web browser, do a “hard refresh” to bypass any saved content in your browser cache. - Ctrl + F5 (most Windows-Linux browsers) - Command + Shift + R (Chrome or Firefox for Mac) - Shift + Reload button toolbar (Safari for Mac)

UPDATE Comment on any paragraph

  • Requires a free account on GitHub http://github.com
  • Select text and click the plus symbol (+) in margin.
  • GitBook section headers and lists cannot accept comments.
  • View other comments in the margins, or all in Discussions.
  • Constructive criticism and suggestions are welcome.
Animation: Comment on GitBook

Animation: Comment on GitBook

UPDATE Suggest revisions on any page

  • Click “Edit on GitHub” at top of any page, which opens new tab.
  • To view the code behind the page, click Raw button.
  • To suggest revisions, click Editor button (pencil symbol). Requires free GitHub account.
  • After entering revisions, scroll down to click Propose File Change.
  • On next screen, click Create Pull Request to submit proposed changes to the book owner.
  • On next screen, click Create Pull Request again to confirm.
  • The book owner will review your suggested revisions, and you will receive automatic notification on any changes.

Propose additional chapters

  • Contact the authors with a summary of your proposed chapter.
  • On the book GitHub repository, fork a copy to your own GitHub account (requires free signup).
  • Create your proposed chapter following the book’s existing folder/file structure.
  • If accepted, the contributing author retains the copyright to their work but agrees to publish it under the Creative Commons BY-NC license. Authors do not receive royalties, but enjoy the eternal rewards of sharing knowledge.