[OPEN-ILS-DOCUMENTATION] New Docs file extension? (.asciidoc or .adoc)

[James Keenan]

+1 to using either .adoc or .asciidoc instead of .txt.

Jim

Jim Keenan
Library Applications Supervisor
jkeenan at cwmars.org<mailto:jkeenan at cwmars.org>
508-755-3323 x23

C/W MARS
67 Millbrook St., Suite 201
Worcester, MA 01606

P   Save a tree! Please don't print this e-mail unless it's really necessary.
Currently reading Becoming Queen Victoria  by Kate Williams.

From: OPEN-ILS-DOCUMENTATION [mailto:open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Remington Steed
Sent: Friday, June 19, 2015 9:35 AM
To: Documentation discussion for Evergreen software
Subject: [OPEN-ILS-DOCUMENTATION] New Docs file extension? (.asciidoc or .adoc)

Hi DIG,

At a DIG meeting on March 5th in IRC, we discussed changing all of our doc files from "NAME.txt" to "NAME.asciidoc" (or "NAME.adoc").  The main benefit of this would be that GitHub would recognize these as AsciiDoc files and would auto-render them as HTML in the browser.  Hopefully this would make it easier for editors to check their work before submitting it.  Here is a summary of our discussion from that meeting:


*         Pro: Would make editing/writing docs on GitHub more friendly

*         Con: Would make editing files on local computer less friendly (if text editor doesn't know .adoc extension, but most editors can be easily configured for this)

*         Shouldn't cause any problems with the automatic HTML conversion

Do you support this change?  Which extension: .asciidoc or .adoc?  Do you have any questions or concerns?  If we decide to move forward, the change could be made easily, any time, and as a single Git commit.  And we could test the nightly conversion process using the master (i.e. dev) branch before applying the change to the 2.8 and 2.7 docs.

Please voice your opinions!

Remington



--

Remington Steed

Electronic Resources Specialist

Hekman Library, Calvin College

http://library.calvin.edu/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20150623/1589ece7/attachment.html>