Sign in

How it works

A quick guide for authors and reviewers.

For authors

  1. Create a book. Give it a title, subtitle, cover image, and a description (written in Markdown, same as chapters).
  2. Add chapters. Upload one or more Markdown (.md) files. You can drag to reorder them, and edit any chapter in place afterward.
  3. Fix missing images. If a chapter references an image that hasn't been uploaded yet, the reader shows an inline upload button right where it's missing — no need to hunt through folders.
  4. Invite reviewers. From the book page, invite by email. You can scope an invitation to the whole book or to a single chapter.
  5. Open a review round. This freezes your current chapters into a snapshot reviewers will read — you can keep editing your draft afterward without disturbing what reviewers are commenting on.
  6. Read and respond to comments. Reviewer comments show up right on each chapter, anchored to the exact passage they're about. Reply, and mark a thread resolved once it's addressed.
  7. Close the round when you're ready to revise further or publish.

For reviewers

  1. Accept your invitation. You'll get an email with a link — sign in with the same email address the invite was sent to, then accept. You can also see all your invitations at any time under Reviews in the header.
  2. Read the chapter(s) you've been invited to. Depending on how you were invited, that's either the whole book or one specific chapter.
  3. Leave a comment. Select any text and a small “Add comment” button appears — your comment stays attached to that exact passage.
  4. Reply to a thread to keep a conversation going with the author, and mark it resolved once it's settled.
  5. Mark a chapter's review complete once you're done with it — useful if you're reviewing across more than one sitting, so you can see at a glance what's left.

Good to know

  • Chapters are plain Markdown — headings, bold/italic, links, images, and code blocks all render.
  • Images are automatically optimized to a lighter WebP version for readers, while your original upload is kept as-is.
  • Manuscripts are private by default — only the owner and reviewers who've accepted an invitation can see a book at all.
  • Sign-in uses your existing Google or GitHub account — no separate password to manage.
How To — Books by SuperML.org