There are two ways to help with this book. They differ in who sees what you write, and in which account you need. Both are in the Contribute menu at the top of every page.
| Who sees it | Account | |
|---|---|---|
| Edit this page | The authors review it. The proposal is public on the book’s GitHub repository, and once it’s accepted your GitHub name appears in the page’s history. | A free GitHub account |
| Note to the authors | The authors. It becomes a public issue on the book’s GitHub repository, showing your name. It doesn’t appear on this page. | None. You give your name. |
Edit this page
Change the wording yourself. Choose Contribute → Edit this page, or the small pencil beside any paragraph to edit just that paragraph.
You sign in with GitHub first; signing in opens a GitHub window, and you come straight back to the paragraph you were on. Make your change, then Propose changes. It goes to the authors as a proposal: nothing in the book changes until they accept it. If they do, your GitHub name appears in the page’s history.
If someone else changed the page while you were editing, your change still reaches the authors, as a note with exactly what you changed.
Note to the authors
Tell the authors about a mistake or an idea, without an account. Choose Contribute → Note to the authors, describe the change and, if you like, why.
You give your name. Your note and your name appear on a public issue on the book’s GitHub repository. It doesn’t appear on the page itself.
Comments in the margin
Public comments in the margin (Hypothes.is) are switched off on this book for now: the margin doesn’t show them, and you can’t add one. Comments for a class, seen only by its members, are planned.
If you have something to say about a page, choose Contribute → Note to the authors.
If something doesn’t work
Choose Contribute → Note to the authors and say what went wrong; it’s almost always something at the site’s end.