====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,
So that the reader can validate the source of the knowledge and read more on the subject.
====Design:
1. Creator experience:
Successful states:
-
Error states:
-
2. Reader experience:
Successful states:
-
Error states:
- Unavailable links
====Acceptance Criteria:
Given a Creator is on the story builder,
When adding text on the text box,
Then they can add a reference(link) related to the text.
Given a reader is reading the text section,
When consuming wiki stories,
Then they can click the available reference(link) that opens on their default/preferred browser.
Given a reader is done reading from the reference(link),
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(link),
When consuming the last (n) wiki story,
Then the back button should take them to the wikipedia article.
====Test Scenarios:
1. Contributor experience:
- Adding references/ links on the text box
- Validating that only the correct format of links are accepted before leaving the page.
- Having a maximum number of references while creating a story.
- Editing references.
- Trying to save the reference 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.
- Deleting the entire reference section, if necessary.
2. Reader experience:
- Should not see a CTA to view references 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:
1. If the reader clicks on the reference/link, do we open a separate page (browser)? When the user taps the Browser's Back button, should it go back to the Wikistory?
2. Should creators be able to add text manually or select from pages?
3. The text section has a maximum number of characters. Should there be a maximum number of references as well?
4. Should users be able to report a reference as incorrect?