What is OFPS?
The Open Feedback Publishing System (OFPS) is an O'Reilly experiment that tries to bridge the gap between private manuscripts and public blogs. Following on the let-them-comment-on-everything model established by the Django Book, Real World Haskell, and Mercurial: The Definitive Guide (among others), OFPS allows readers to read in-progress O'Reilly manuscripts, communicate suggestions with the authors, follow others' comments, and directly participate in the development of new books.
Manuscripts developed with OFPS sites allow the authors to publish the in-progress work as whenever they think it's ready for public comment and then update the site with new versions as the text is improved. Authors note sections of the text that they'd like comments on (potentially down to an individual paragraph) and that allows readers on the site to comment on that particular section.
You can add a new comment on a section by clicking on the "Add a comment" link under the section itself, or participate in an ongoing discussion with other readers by clicking "View 19 comments."
If you'd like to see all of the comments added to a page, click "Show all comments" at the top.
If you'd like to follow the stream of comments, just add either an individual chapter's feed or the whole book's feed to your feedreader. Each comment will be added to the feed with a little bit of context from the book.
Because we'd like to be able to credit commenters in the book and want to foster a constructive dialog, we require users to register and sign in before adding new comments. If you'd just like to read, there's no need to register. A, "SIGN-IN OR REGISTER" link is located at the top of each page.
Your contributions and submissions to any OFPS site are made under the same license as the book. See the standard O'Reilly Terms of Service for the details.
Please send feedback or bug reports about the OFPS system to firstname.lastname@example.org.
Programming Scala was the first OFPS site.
How to Sign In
In order to comment on O'Reilly OFPS titles you'll need to sign in to or create a new oreilly.com account. We ask users to sign up in order to credit commenters in the book and to help foster a constructive dialog. Also, please note that your contributions and submissions to any OFPS site are made under the same license as the book. See the standard O'Reilly Terms of Service for details.
To get started click on the "SIGN-IN" link at the top of each OFPS page. You'll be directed to a page where you can sign in with your oreilly.com account if you already have one, or create a new oreilly.com account. Once you've signed in you'll be taken back to the OFPS page that you were previously reading.
To sign out click the, "SIGN-OUT" link at the top of any OFPS page.
How to Comment
To leave a comment click on, "Add a comment" or, "View # Comments" link to the right of every paragraph. If you are logged in, a space for you to enter your comment will be available beneath the paragraph you will be commenting on. If there are other comments already on that paragraph, the form will be beneath the most recent comment. If you are not signed in with your oreilly.com account you'll be asked to do so. For more information about signing in or setting up an oreilly.com account see the instructions above.
Once you've logged in you can enter your comment in the text area. Markdown syntax is supported for style and formatting, but is not required. When you are finished with your comment click the, "submit" button.
How to Edit or Delete a CommentYou may edit or delete any comment you have made with your oreilly.com account. To do so, locate the comment you wish to modify. You must be logged in. If you are logged in, and the comment was made by the user you are currently logged-in as, an "edit comment" link will be displayed in the comment's header. Clicking on this link will display a form in which you can edit or delete your comment. Note that deleting your comment does not delete it from the server.
How to Navigate
The home page of each OFPS title contains a complete table of contents (TOC) for that text. Clicking on a section in the TOC will take to that particular section, which is located whithin a chapter.
At the top and bottom of each page there are, "Previous" and ,"Next" buttons allowing you to step back and forwards between chapters. There is also the book's title, which links to the titles home page which contains the TOC.
Where to Get Help
If you have any questions regarding OFPS or need help please contact email@example.com.