====== Agenda ====== ===== Introductions ===== Please introduce yourself using the #info command. For example: #info tay_tay is Taylor Swift, Wyomissing Public Library ===== Develop consensus on project requirements ===== The following agenda items are based on the [[http://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:reorg_2014:requirements|Proposed project requirements document]]. ==== Values check ==== * Do the [[http://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:reorg_2014:requirements#ideas_expressed_about_this_project|values listed in the requirements document]] work for everybody? ==== Specific goals ==== * Any discussion points here? ==== 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's recent docs survey: * 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, coworker, IRC, printed/handwritten notes, online documentation, youtube, my library's training documentation) * 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's training materials * 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 ==== Specifically, let's talk about: * Platform (Asciidoc vs. flossmanuals vs. something else)? * If consensus on Asciidoc, how to create crosslinks? * Which audiences should we target? For this discussion, we can use [[evergreen-docs:reorg_2014:audience_focused_layout|remingtron's draft as a starting place]] ===== Identify compilers ===== These people would be responsible for individual "books" ===== 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. It would also be good to work towards a plan for assessing this work. ===== Timeline ===== If we have time, it would also be nice to start filling in the [[http://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:reorg_2014:requirements#proposed_timeline|timeline on the requirements doc]].