[OPEN-ILS-DOCUMENTATION] proposal: update "Statistical Categories Editor" document

[Soulliere, Robert]

Hi Scott,

If you clone the branch into a github repo and let us know when the docs are ready, I will get it into the main documentation repository.

I am not sure about the precise contact. A few DIG participants are from SITKA:
http://www.open-ils.org/dokuwiki/doku.php?id=evergreen-docs:digparticipants&#evergreen_dig_participants

Email is not listed for them so hopefully someone can provide some guidance on who to contact.

Thanks,
Robert





Robert Soulliere, BA (Hons), MLIS
Systems Librarian
Mohawk College Library
robert.soulliere at mohawkcollege.ca
Telephone: 905 575 1212 x3936
Fax: 905 575 2011
________________________________________
From: open-ils-documentation-bounces at list.georgialibraries.org [open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Scott Prater [sprater at gmail.com]
Sent: March 26, 2012 10:16 AM
To: Documentation discussion for Evergreen software
Subject: Re: [OPEN-ILS-DOCUMENTATION] proposal: update "Statistical Categories Editor" document

Hi, Robert --

Asciidoc is fine with me:  I'm partial to ascii-based markup
languages, also (I use markdown to write most of my docs).

As far as creating a branch goes, I have rights to push to the working
repo, but not to the documentation repo (as far as I know).  Which
repo is it where current work is being done (is it still
Evergreen-DocBook)?  Would you prefer that I clone the repo to my area
in github, and let everyone know when I have a document ready? (That's
the way I did most of my work for the statistical category
enhancements.)

I see that the SITKA document is a bit more current:
http://docs.sitka.bclibraries.ca/Sitka/current/html/lsa-statcat.html

Do you have a contact name/email for someone at SITKA I could reach?

thanks,

-- Scott

On Mon, Mar 26, 2012 at 9:03 AM, Soulliere, Robert
<robert.soulliere at mohawkcollege.ca> wrote:
> Hi Scott,
>
> Creating a branch and having us merge your changes as you have described is definitely a good way to go.
>
> One note on our documentation. As of version 2.2 we have changed to asciidoc (http://www.methods.co.nz/asciidoc/manpage.html)  as the official documentation format base. If you are writing docs specific to version 2.2 or later, you might want to write your documentation in ascidoc format.
> You will notice that the master branch of our documentation is all in ascidoc when you clone our repo, so you might want to write the documentation in asciidoc if possible. We will accept docBook format if that is your preference and that is still the official format of for documentation contributions for 2.1 and earlier as you have seen in the branches.
>
> I am not sure about whom to collaborate with for updating content. SITKA was the original source for the documentation for that chapter and they have since updated their documentation, so they might be a good starting point. Perhaps, those more familiar with the content of this chapter can provide more guidance?
>
>
> Thanks,
> Robert
>
>
>
>
>
>
>
>
>
>
>
> Robert Soulliere, BA (Hons), MLIS
> Systems Librarian
> Mohawk College Library
> robert.soulliere at mohawkcollege.ca
> Telephone: 905 575 1212 x3936
> Fax: 905 575 2011
> ________________________________________
> From: open-ils-documentation-bounces at list.georgialibraries.org [open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Scott Prater [sprater at gmail.com]
> Sent: March 25, 2012 3:46 PM
> To: open-ils-documentation at list.georgialibraries.org
> Subject: [OPEN-ILS-DOCUMENTATION] proposal: update "Statistical Categories      Editor" document
>
> I've made some changes to the Statistical Categories Editor interface,
> documented here:
>
> http://evergreen-ils.org/dokuwiki/doku.php?id=dev:proposal:patron_statistical_categories
>
> and I'd like to contribute documentation for the new features.
>
> It looks like the latest public version of the document is here:
>
> http://docs.evergreen-ils.org/2.0/draft/html/lsa-statcat.html
>
> and it appears to be out-of-date, as there are more fields now, and
> the layout has changed somewhat.
>
> What would be the best approach for submitting an updated document?  I
> see that there's a git documentation repository, with
> Docbook-formatted documentation in it.  Should I clone that
> repository, create a branch, update the document in the branch, and
> open a Launchpad bug when the updated document is available?
>
> Also, the work I did is for patron statistical categories;  there have
> been other changes made to the statistical categories editor besides
> mine since this draft version of the documentation.  With whom should
> I collaborate to get an updated version of this document together?
>
> thanks,
>
> -- Scott
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>
> This E-mail contains privileged and confidential information intended
> only for the individual or entity named in the message.  If the reader
> of this message is not the intended recipient, or the agent responsible
> to deliver it to the intended recipient, you are hereby notified that
> any review, dissemination, distribution or copying of this communication
> is prohibited.  If this communication was received in error, please
> notify the sender by reply E-mail immediately, and delete and destroy
> the original message.
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

This E-mail contains privileged and confidential information intended
only for the individual or entity named in the message.  If the reader
of this message is not the intended recipient, or the agent responsible
to deliver it to the intended recipient, you are hereby notified that
any review, dissemination, distribution or copying of this communication
is prohibited.  If this communication was received in error, please
notify the sender by reply E-mail immediately, and delete and destroy
the original message.