# Arch Site: Vision Document ## Links & Reference - [Whimsical (Wireframes)](https://whimsical.com/arch-site-N6HWMe3AcmUoSsCxXB6YeT) ## Site ### Sections - Home / About - Poetry - able to post new entries (text only) - Short Stories - able to post new entries (text only) - Music - link to soundcloud ### Style - very bare - black on white ## User Stories <details> <summary><strong>Note for Arch</strong> <em>(click to expand)</em></summary> > **Note for Arch:** “user stories” are a pretty typical method in software/web development used to track project progress and maintain a focused development path. > > Below, you’ll find a list of named “characters” that represent the types of users to which this site caters. > > Then, you’ll find a list of features framed with a specific type of user in mind. > These help us clarify what abilities users should have; and as we continue to build the application, it will help us keep track of what is done and what is not. </details> ### Characters / Personas - Arch: - owner of site; - all the content on the site either (1) centers around him or (2) was created by him - Penny: - regular user of the site; - a long-time fan of Arch's work; - likes to stay up to date with new posts; - has favorite works, returns to read them regularly; - (+) maybe interested in commenting on one of her favorite works - Xan: - one-off visitor of the site - interested in taking a peek around, but won't stay anywhere all too long - likely wants to peruse in an exploratory fashion; didn't come to the site expecting anything or looking for any specific item ### Features - Arch can log into site - Arch can change his log-in credentials - Arch can... - *(**Note**: all of the following stories would be duplicated for both Poems and Short Stories)* - Publish a new TEXT - View an existing TEXT - Edit the text content of an existing TEXT - Delete an existing TEXT - SAVE an unpublished draft of a new TEXT - Unpublish a published TEXT (revert to Draft) - (+) Arch can view a WYSIWYG preview of the post he's currently editing - (+) Arch can hide comments in his text; whether in draft-mode or full-publish, commented-out text will be hidden from readers but visible to Arch when editing. - Xan can find things easily; it's clear where everything is located - Penny can share/copy a link to her favorite poems - (+) Penny can add a comment - (+) Penny can share a link to a specific line / text-snippet - (+) Arch can respond to Penny's comment - (+) Arch can delete (or "hide") Penny's comment - Penny can bookmark her favorite poems - Penny can search a specific passage to find the poem it belongs to - Penny can search the title of a poem to find it faster - Penny doesn't need to scroll endlessly to find her favorite poem - Xan can continuously explore through the content on the site **(+):** Possible "bonus" feature. (The extra credit features; would be nice, is not high priority.) ## Additional Notes ### Text Editor Arch needs a way to upload new entries and edit existing ones. A few possible ways this feature could be implemented: 1. The ability to "submit" from a Google Doc 2. write/paste into some sort of editor on the site itself 3. fill out a more "structured" form-like thing on the site itself 4. some other way entirely The most promising two approaches are (1) uploading from Google Docs and (2) including an in-site editor. - Google Docs - Pros - Google has spent a lot of money and time developing a pretty kick-ass editor - Docs is the platform that Arch uses to write his content, anyway - would allow Arch to use whatever fonts he wanted for editing, but would translate docs over to a consistent format for the site - certainly more accessible for continuous edits from Arch - Cons - Not internal to site - Harder to get a WYSIWYG preview; a less ideal approach for purely visual edits from Arch - In-Site Editor - Pros - better for more instant edits for Arch to tweak things - internal to site! - easy to get a WYSIWYG preview - allows for more granular relationship between what happens in the database and what Arch works with - TBH would be pretty cool for Arch to just have an editor developed just for him :smile: - Cons - a more complex implementation - definitely not going to be as usable as Google Docs ### Platform Considerations - Assumptions & Thoughts - Arch will likely spend the most time on this website, at least until he blows up ;) - Arch will probably use Desktop more than Mobile - Site visitors will likely use Mobile more than Desktop, given the fact that it's reading peoms and short stories - Take-aways: - we'll want a very clean mobile design with very few visual bugs - for the sake of Arch's happiness, Desktop shouldn't be ugly - Desktop can prioritize functionality > visual appearance - Admin-only views can prioritize Desktop layout!