How to Read and Comment

by Jack Dougherty, last updated February 28, 2017

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."

We designed the book to be read online, in any modern web browser, on desktops, laptops, or mobile devices. The online edition features interactive charts and maps that you can explore, and video tutorials that you can view at your own pace. If desired, readers can freely download any of the ebook editions--PDF or ePUB or Mobi/Kindle--but these do not include the interactive features in the online web edition. Learn more about how GitBook works and publish your own book.

Keep your place when reading online and moving between pages.

  • Two-finger trackpad click
  • or Control + click (Mac)
  • or Alt + click (Chromebook)
  • or right-click (Windows and others)
Screenshot: Open link in new tab (on Mac)
Screenshot: Open link in new tab (on Mac)

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)

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

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 lead author 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, in GitHub/GitBook Markdown format, as described in this chapter about GitBook.
  • 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.

Data Visualization For All is copyrighted by Jack Dougherty and contributors and distributed under a Creative Commons Attribution-NonCommercial 4.0 International License. You may freely share and modify this content for non-commercial purposes, with a source credit to http://DataVizForAll.org.
Improve this book: Donate to DataViz students and add comments or revisions.

results matching ""

    No results matching ""