-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the Draft Outloud wiki!
The content here is intended for developers and people deploying a web site based on Draft Outloud. There is nothing in this wiki about any individual book served from a web site using Draft Outloud.
- Source code in github
- Development plans in Pivotal Tracker
- Beta-testing site/book: "Tracking Flow: Coordinating Teams with Pivotal Tracker"
- Twitter feed
Draft Outloud is a web application written on the Ruby-on-Rails framework. Draft Outloud serves the content of a book, to allow for public feedback. The original source of the book is expected to be in a source-control system accessible over the web (currently only git, such as GitHub) and stored in a standardized format (currently only DocBook XML, with a handful of conventions about file placement that Draft Outloud expects).
The primary criteria that motivated the creation of Draft Outloud instead of the reuse of an existing system were to:
- Present the book's content in a way that allows for the book being only partially complete and updated frequently.
- Allow people to read the book on the web, or download the current draft of the book in a format conducive to off-line reading.
- Allow readers to indicate what unwritten or incomplete portions of the book they're most interested to see written next.
- Allow readers to ask questions or describe subject matter which they would like to see the completed book address.
- Allow readers to give feedback on existing sections: suggest changes, point out type-o's, etc.
- Support a book storage/input format that is also convenient for the production of a print edition of the book.
So why not just use a wiki? In addition to wanting to clearly separate the authorship and readership of the book, and support actually drafting the book's content off-line, wiki's generally aren't linearly structured the way a book is. "Draft Outloud" will format cross-references and such within the book as HTML links, but is generally more book-like than web-like in its presentation.