---
# System prepended metadata

title: 'Arch Site: Vision Document'

---

# 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!
