evergreen-docs:reorg_2014:agenda_2016-02-10
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
| evergreen-docs:reorg_2014:agenda_2016-02-10 [2016/02/09 12:07] – [Values check] sandbergja | evergreen-docs:reorg_2014:agenda_2016-02-10 [2016/02/10 14:57] – [Requirements] rjs7 | ||
|---|---|---|---|
| Line 5: | Line 5: | ||
| | | ||
| ===== Develop consensus on project requirements ===== | ===== Develop consensus on project requirements ===== | ||
| - | [[http:// | + | The following agenda items are based on the [[http:// |
| ==== Values check ==== | ==== Values check ==== | ||
| * Do the [[http:// | * Do the [[http:// | ||
| ==== Specific goals ==== | ==== Specific goals ==== | ||
| + | * Any discussion points here? | ||
| ==== Requirements ==== | ==== Requirements ==== | ||
| + | * Any discussion points here? | ||
| + | * Gather requirements from users (idea from remingtron) | ||
| + | * Let's consider getting feedback from documentation users to help guide our efforts. Maybe a broad survey to understand general needs. | ||
| + | * Some of the following questions are borrowed from another open source project' | ||
| + | * How do you use Evergreen? (sys admin, staff client admin, circ superuser, circ normal user) | ||
| + | * How often while using Evergreen do you want help? | ||
| + | * Where is the first place you go for help? (supervisor, | ||
| + | * What are you looking for when you seek out information on Evergreen? | ||
| + | * User Guides | ||
| + | * New Features and Version Info | ||
| + | * Best practices on how to use Evergreen as an end user | ||
| + | * Installation Documentation | ||
| + | * Technical Specs | ||
| + | * Development Documentation | ||
| + | * Presentations | ||
| + | * Other | ||
| + | * In learning materials for Evergreen, which medium(s) would work best for you? | ||
| + | * HTML on the website | ||
| + | * PDFs with text and screenshots | ||
| + | * Short topical videos | ||
| + | * Other | ||
| + | * Which sources have you used to find answers about using Evergreen? | ||
| + | * Official Evergreen website (www.evergreen-ils.org) | ||
| + | * Official Evergreen Documentation website (docs.evergreen-ils.org) | ||
| + | * Evergreen Wiki (wiki.evergreen-ils.org) | ||
| + | * My library' | ||
| + | * Other | ||
| + | * Are the documents and files you found on evergreen-ils.org what you expected or needed? | ||
| + | * No, it did not meet my needs or was confusing | ||
| + | * Somewhat, but a few things were missing or confusing | ||
| + | * Yes, I was completely satisfied | ||
| + | * I do not use the website evergreen-ils.org | ||
| + | * How difficult was the installation? | ||
| + | * FREE FORM QUESTIONS | ||
| + | * Which of the existing documentation options have you found the most useful, and why? (or as a rating question) | ||
| + | * Is there any documentation you were unable to find or would like to see? (or "Have you had questions you were not able to answer using the docs?" | ||
| + | * What ongoing challenges do you face when using Evergreen documentation / training materials? | ||
| + | * Is there anything else that you would like to add or change about the Evergreen documentation? | ||
| ==== Ideas ==== | ==== Ideas ==== | ||
| Line 17: | Line 56: | ||
| * Platform (Asciidoc vs. flossmanuals vs. something else)? | * Platform (Asciidoc vs. flossmanuals vs. something else)? | ||
| * If consensus on Asciidoc, how to create crosslinks? | * If consensus on Asciidoc, how to create crosslinks? | ||
| - | * Which audiences should we target? | + | * Which audiences should we target? |
| - | ==== Identify compilers ==== | + | ===== Identify compilers |
| These people would be responsible for individual " | These people would be responsible for individual " | ||
| + | |||
| + | ===== Testing and assessment plan ===== | ||
| + | If we have time, it would be great to come up with a plan for testing these reorganized docs on end-users. | ||
| + | |||
| + | ===== Timeline ===== | ||
| + | If we have time, it would also be nice to start filling in the [[http:// | ||
evergreen-docs/reorg_2014/agenda_2016-02-10.txt · Last modified: 2022/02/10 13:34 by 127.0.0.1