diff --git a/MVP.md b/MVP.md index 68eaa6c4..7bf737f7 100644 --- a/MVP.md +++ b/MVP.md @@ -2,52 +2,66 @@ We're still working on this document so it should be constantly changing. _**All comments and pull requests welcome!**_ -##[MVP Feature set](https://github.com/ideaq/time/issues/67) -**Alpha:** ++ [MVP feature set](#MVP-Feature-set) ++ [Minimum UI](#Minimum UI) + + **[Open Questions for MVP & beyond](#open-questions)** + +
+ +##MVP Feature set +[**Alpha feature set:**](https://github.com/ideaq/time/issues/67) * Log in as a user (to enable timers to be saved) +* Log out * Start a timer * Stop that timer * Give that timer a description * Start a new timer -* _[Add category to that timer](#mvp-categorisation)?_ -
-##Common points of friction +###Common points of friction Day-to-day time tracking **can't feel like work** or it'll stop being an effective tool [upcoming blog post on this topic!]. What we really want is **the minimum number of steps** to accomplish our task - starting a timer. So **what are the _biggest_ time wasters** to try and avoid? * **Too much initial setup:** If you’re going to ask me to create all of my projects, rates or set up a bunch of timers **_up front, before I can start using the app_** in a useful way, that’s burdensome. I don’t even know _how_ I’m planning on using the app yet! * **Too much overhead to start a timer:** Having to type a description and _then_ assign a category and _then_ decide what other options to add to my timer when really, all I want to do is start it and get on with life. -
##[Minimum UI](https://github.com/ideaq/time/issues/31) -**Minimum solution to points of fiction:** Allow [people](https://github.com/ideaq/time/issues/33) to start a timer _with **one tap**_ and _without_ the need to add further information to it. Any necessary details can be filled in later _(at this stage)_. - -**To be considered post MVP:** Allow people to fill in additional timer details at the same time as they start the timer. - - -###The great categorisation debate -The question of _'Should we include categorisation as part of the MVP?'_ has been raised. [One camp suggests this is not part of 'the bare necessities'](https://github.com/ideaq/time/issues/67#issuecomment-78227827) and should be a feature voted on by the community. - -The other camp suggests that given the [Minimum UI](#minimum-ui) currently proposed, categorisation **is** an MVP feature because otherwise people will end up with a mass of timers and **won't remember what they were all for** when they need to come back to them. - -Our goal is to save people time and I would argue that **timer data needs to have either a description or a category attached for it to be useful** enough so that some conclusions can be drawn from it. - -_**[Conclusion required!](https://github.com/ideaq/time/issues/67)** - suggest this feature is built last in the sprint if there's time_ - +**Minimum solution to points of fiction:** Timer starts automatically when [people](https://github.com/ideaq/time/issues/33) open the app/webpage. Also allow them to start a timer _with **one tap**_ and _without_ the need to add further information to it. ###Screens First partial UI sketch, keeping it as simple as possible. _To be iterated over._ -![First sketch](https://cloud.githubusercontent.com/assets/4185328/6601248/7717a73c-c80c-11e4-9a86-066934c90dce.jpg) - _**Initial suggestion -**_ Minimal number and content of screens as follows: -* Simple login screen, shown as default unless user is logged in already -* Main screen: - * Timer, set to 00:00 to begin with (**open question:** seconds & minutes with hours added dynamically when required?) - * Log of today's stopped timers (**open question:** just today's? Should MVP[alpha] be concerned with displaying more than today's data despite it being saved?) - * _[TBC](https://github.com/ideaq/time/issues/67) - categories activated with one tap_ - * _[TBC](https://github.com/ideaq/time/issues/67) - description field for timer_ +* Main screen: + * Timer, set to 00:00 to begin with (seconds & minutes, with hours added dynamically when required) + * Description of timer with placeholder text + * Log of today's stopped timers + * Simple login area, shown as default unless user is logged in already * Additional items required at this point: + * Some way of [knowing user is logged in](https://github.com/ideaq/time/issues/85) * Logout button + +![First sketch](https://cloud.githubusercontent.com/assets/4185328/6601248/7717a73c-c80c-11e4-9a86-066934c90dce.jpg) + +A few more sketches of potential **MVP alpha** screens to start understanding the user experience, leading to [more open questions](#open-questions): + +![User experience screen flows](https://cloud.githubusercontent.com/assets/4185328/6856657/5f501c12-d3f9-11e4-9424-62774075afb2.jpg) + + +##Open Questions +Some of our UI open questions _**have**_ to be answered **before the MVP** as they touch our MVP feature set: +* Does the user need to press anything to submit/confirm the description of the timer? +* How does the user edit the timer description? Tap to edit? +* Do we need both an email and a password requested on the main screen or just an email? +* Do we [allow anonymous users to have run more than one timer](https://github.com/ideaq/time/issues/58) before they have to register to save them? +* What is the best way to [show a user they are logged in](https://github.com/ideaq/time/issues/85)? +* What is the simplest way to deal with [remembering users so they don't have to constantly log in](https://github.com/ideaq/time/issues/45) at MVP or should we be doing this at this stage at all? + +Some initial questions **to be answered by the MVP** also surfaced whilst putting together the UI: +* How does the user edit the timer description? Tap to edit? + * How does the user edit a _past_ timer description? Especially if tapping a past timer restart it... +* Should _past_ timers shown on main page show the total time spent on that activity for a period (today or the current week for example) or just the last time the timer was used? +* Should just today's timers be shown on the main page of the app? Or Today + Yesterday? Or the full week? +* Should clicking on a _past_ timer on the main page [restart it](https://github.com/ideaq/time/issues/30#issuecomment-75047797)? +* How do we edit _past_ timer descriptions? +* Do we need both an email and a password requested on the main screen or just an email?