ManifoldScholar / manifold

Transforming scholarly publications into living digital works.
http://manifoldapp.org
GNU General Public License v3.0
237 stars 31 forks source link

"Suggest Revision" or "Revise" alongside "Highlight" and "Annotate" #2639

Open jeffwgallant opened 4 years ago

jeffwgallant commented 4 years ago

Feature Description

A "Suggest Revision" menu item when a reader highlights text.

Why is this feature important? Who does it help?

This feature helps open textbook publishers and creators primarily, while helping faculty participate in the process. Having an errata report feature as up-front as possible and as usable as possible will encourage faculty, designers, and students to assist publishers in the iterative improvement of open textbooks. This is a key part of keeping OER sustainable in the long-term without the typical commercial publisher tactic of charging biannually for new editions.

User Stories

As an open textbook author, I want to know when faculty find a mistake. I don't want them to dismiss the text just because of an error--I want to fix the error!

As a faculty instructor, I want to let authors know when I see a typo, a factual error, or an update to what we know about a particular topic. I want to participate in keeping open textbooks sustainable, instead of passively dismissing an open textbook with an error in favor of an expensive text.

As an open textbook publisher, I want sustainability. A quick and easy way to suggest changes to textbooks is crucial to the constant improvement of the resources we provide to faculty, ensuring a higher level of quality throughout the life of the text.

Design Notes

This would open a kind of shared annotation between the reader, the authors and editors, and the admins. Authors, editors, and admins would get an email notification that the revision was suggested, along with who the suggestion came from in order to contact them with any followup questions.

This would be a feature that could be turned on and off on a text or project level. We understand that not every publisher of scholarly content on Manifold would want, or need, this functionality.

Also, it's tough to come up with a short enough term to fit alongside "annotate" and "highlight." "Revise" makes sense, but might suggest a little too much agency to the reader.

Development Notes

None here!

tiffaniktijerina commented 4 years ago

Design: Maybe if the button is called "Revise," there could be an explanation on the submission bar that explains they are making a suggested revision to the authors of the text. I also think these edits should go in as private suggestions so that authors can vet them before they are displayed to the world, in case the suggestion doesn't work for their text.