Differences

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

--- evergreen-docs:dig_participation [2018/11/06 15:55] – [First Steps] rjs7
+++ evergreen-docs:dig_participation [2025/06/05 12:18] (current) – dluchenbill
@@ Line 3: / Line 3: @@
 Contributing to documentation is an excellent way to support Evergreen, even if you are new to documentation. In fact, beginners often have a distinct advantage over the experts, more easily spotting the places where documentation is lacking or where it is unclear.
-We welcome your contribution with planning, writing, editing, testing, converting to AsciiDoc, and other tasks. Whatever your background or experience we are keen to have your help!
+We welcome your contribution with planning, writing, editing, reviewing, converting to AsciiDoc, and other tasks. Whatever your background or experience we are keen to have your help!
 ==== First Steps ====
-  * Join the Evergreen **documentation listserv**: [[http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation]]. This is the primary way we communicate with each other. Please send an email introducing yourself to the list.
+  * Join the Evergreen **[[https://list.evergreen-ils.org/mailman3/lists/evergreen-documentation.list.evergreen-ils.org/|documentation discussion list]]**. This is the primary way we communicate with each other. Please send an email introducing yourself to the list.
-  * Check out the newest **[[evergreen-docs:documentation_needs|documentation to-do list]]** (especially the EASY section) to see which areas need work, and mention on the [[http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation|listserv]] which areas you're interested in working on. For large chunks of documentation you may want to see if there are other people who would like to team up with you.
+  * Check out the **[[evergreen-docs:documentation_needs|documentation to-do list]]** (especially the EASY section). If you want help with a task, just ask on the [[https://list.evergreen-ils.org/mailman3/lists/evergreen-documentation.list.evergreen-ils.org/|documentation discussion list]].
-  * Attend a DIG [[evergreen-docs:dig_meetings|meeting]] in IRC.  Meetings are announced on the [[http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation|listserv]].
+  * Attend a **[[evergreen-docs:dig_meetings|DIG meeting]]** in IRC.  Meetings are on the [[calendar:start|community calendar]] and announced on the listserv.
-  * Write documentation in any format and send it to the [[open-ils-documentation@list.georgialibraries.org|documentation email list]].  We will review your files, convert them to AsciiDoc format and add them to the official documentation when they are ready.
+  * Write documentation in **any format** and send it to the [[evergreen-documentation@list.evergreen-ils.org|documentation discussion list]].  We will review your files, convert them to AsciiDoc format and add them to the official documentation when they are ready.
-  * If you are comfortable with AsciiDoc formatting, you can [[evergreen-docs:how-to-contribute-documentation|contribute documentation directly]].
+  * If you are comfortable with AsciiDoc, you can [[evergreen-docs:how-to-contribute-documentation|contribute documentation directly]].
   * Add yourself to the [[evergreen-docs:DIGParticipants|participant list]] if you have an Evergreen DokuWiki account, or send a request to [[docs@evergreen-ils.org]].
 ==== Volunteer roles ====
-We are now looking for people to help produce the documentation. If you interested in participating, email the DIG facilitators at [[docs@evergreen-ils.org]] or speak up on the documentation mailing list.
+We are now looking for people to help produce the documentation. If you interested in participating, email the DIG facilitator(s) at [[docs@evergreen-ils.org]] or speak up on the documentation mailing list.
 We're looking for volunteers to work on the following:
@@ Line 26: / Line 26: @@
   * [[http://www.methods.co.nz/asciidoc/userguide.html|User Guide]] -- Detailed guide for AsciiDoc syntax. (methods.co.nz)
-**Testing** -- Comparing the documents with the functions they describe
+**General Review** -- Comparing the documents with the functions they describe (i.e. testing the step-by-step instructions with the matching version of Evergreen)
-**AsciiDoc conversion** -- For existing files that are not already in AsciiDoc, and new ones created by people writing in other formats
+**Editorial Review** -- Ensuring the documentation is clear and follows Evergreen DIG style guide conventions
-**Editorial review** -- Ensuring the documentation is clear and follows Evergreen DIG style guide conventions
 **CSS Design** -- Making the pages more attractive and user-friendly
+**AsciiDoc conversion** -- For existing files that are not already in AsciiDoc, and new ones created by people writing in other formats
+  *[[https://alldocs.app/convert-word-docx-to-asciidoc|Word to AsciiDoc]]
 <html><!--
 **XML Transform and Committers** -- Converting the files to HTML and PDF, making permanent changes, and uploading the files