User Tools

Site Tools


evergreen-docs:reorg_2014:agenda_2016-02-10

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
evergreen-docs:reorg_2014:agenda_2016-02-10 [2016/02/09 12:11] – fixing headings sandbergjaevergreen-docs:reorg_2014:agenda_2016-02-10 [2022/02/10 13:34] (current) – external edit 127.0.0.1
Line 5: Line 5:
      
 ===== Develop consensus on project requirements ===== ===== Develop consensus on project requirements =====
-[[http://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:reorg_2014:requirements|Proposed 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 ==== ==== 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?   * 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?
Line 13: Line 13:
 ==== Requirements ==== ==== Requirements ====
   * Any discussion points here?   * 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 ==== ==== Ideas ====
Line 19: 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?  For this discussion, we can use [[evergreen-docs:reorg_2014:audience_focused_layout|remingtron's draft as a starting place]]
  
 ===== Identify compilers ===== ===== Identify compilers =====
evergreen-docs/reorg_2014/agenda_2016-02-10.1455037867.txt.gz · Last modified: 2022/02/10 13:34 (external edit)

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.