-
Notifications
You must be signed in to change notification settings - Fork 0
Repo Project Overview (for README) #7
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
Potentially related to #3 (project overview presentation), having a clear project overview in the repo would help to clarify things. @vr00n also posted a good example (thanks for posting those Varun). While the RFP's detail is overkill for a readme, it hits some necessary points I included above (e.g., success measurement). Another thing to consider from Varun's post, is the user journey. They're useful to develop the goals. For example, thinking about user needs, ways to quantify them, and solutions to meet them would help fill out the sections "Problem Definition", "Goals", and "Success/Goal Measurement". This template from Code for San Francisco is potentially useful too, though I don't have time to break it down now. |
Also relates to Tutorial Design since the screenshots and/or prototypes will evolve as we get audience input. That said, we should consider making the goals loose enough to allow for iterative design phases. On one hand we're unlikely to hit an optimal design on the first iteration if we don't know what works. On the other, a first iteration could be the definition of "Done" for a V1, with the assumption we'd go on to V2. That may make scoping the project easier. Need to think about / research that. |
Should include maintenance plan. |
Uh oh!
There was an error while loading. Please reload this page.
The point of this issue is to aggregate ideas for the project readme. As the comments develop, I'll update the description. Please suggest sections if you think of any. The comments have some ideas.
Tentative Sections:
The text was updated successfully, but these errors were encountered: