Background:
Allow contributors to add the reference for Wikistories when editing article text or adding text from other sources.
Description/User story:
As a wiki story creator,
I would like to add a reference to the wiki story text that is copied from the article,
So that the reader can validate the source of the knowledge and read more on the subject.
As a wiki story creator,
I would like to add a reference/citation to the wiki story text that is written by me,
So that the reader can verify the source of the knowledge.
Design:
- Creator experience:
Successful states:
Error states:
- Reader experience:
Successful states:
Error states:
- Unavailable links
Acceptance Criteria:
Given a Creator is on the story builder,
When adding text from an article on the text box,
Then they can add a reference/citation related to the text.
Given a Creator is on the story builder,
When writing text on the text box,
Then they can add a reference/citation related to the text.
Given a reader is reading the text section,
When consuming wiki stories,
Then they can click the available reference/citation that opens on their default/preferred browser.
Given a reader is done reading from the reference/citation,
When consuming 1-(n-1) wiki stories,
Then the back button should take them to where they left off and continue watching subsequent stories.
Given a reader is done reading from the reference/citation,
When consuming the last (n) wiki story,
Then the back button should take them to the wikipedia article.
Test Scenarios:
- Contributor experience:
- Adding reference/citation in the text box if the text came from an article.
- Adding reference/citation in the text box if the text was written entirely by the creator.
- Validating that only the correct format of reference/citations are accepted before leaving the page.
- Having a maximum number of reference/citations while creating a story.
- Editing reference/citations.
- Trying to save the reference/citation section with no references should how an error (or close without showing the section)
- Incorrect URL format should show an error when trying to save a reference/citation.
- Deleting the entire reference/citation section, if necessary.
- Reader experience:
- Should not see a CTA to view reference/citation if not available
- Available links - should be able to click on them and view the source
- Unavailable links - the browser should still be opened and show a webpage unavailability.
Open questions:
- Should creators be able to add text manually or select from pages?
- The text section has a maximum number of characters. Should there be a maximum number of reference/citations as well?
- Should users be able to report a reference/citations as incorrect?
Additional thoughts:
Scenario 1: unedited copied text that has references already [read more]
Scenario 2: unedited copied text that has no references
Scenario 3: edited copied text that has no references
Scenario 4: writing text from scratch
Also, References make sense if wiki-stories are shareable(share feature)
Since wiki stories already live in articles, is there a need to have references.