[OPEN-ILS-DOCUMENTATION] no training session this Thursday, however...

[Karen Collier]

Jason, Dan, etc.,

Here are some thoughts and questions for going forward.

Maybe in a future training session, as a group, we could look through the Wiki and the DocBook outline to see what's missing and focus discussion on those areas?  

It seems that most of what we've covered so far would fit under the "Evergreen End-user Documentation" link on the Wiki and in Parts IV and V of VII in The Book of Evergreen.  I wonder if the intent is for us to focus primarily on those areas, perhaps making them more prominent in the documentation with the assumption that that's what most people will be interested in, or if there are other areas of documentation that need work, for which we could be trained?

The other thing I'd be curious to see would be a tour through the source tree, not necessarily in any great detail, but for example, what kinds of things would be found in the Evergreen directory vs the Open-ILS directory, or what's the logic used to divide different parts of the code into different directories.  Or how do I know where to start looking for the code affecting a particular feature for purposes of documenting it?

I also have some questions specifically about The Book of Evergreen, and Dan's intentions for that.  Should we be refining the Wiki with the assumption that parts of it will be lifted, polished, and inserted into the DocBook document?  Or is this meant to be original documentation, perhaps organized differently than the Wiki is that we should be writing and either sending to Dan or to this list?

Just my two cents.  :)

Thanks,
Karen

----- "Jason Etheridge" <jason at esilibrary.com> wrote:
> I will be available on skype after 2:30pm EST tomorrow if anyone
> wants
> to pick my brain for anything.  I believe we've covered just about
> every application-level topic except reporting, which is an area I
> need to brush up on.  If you guys have any thoughts for what we
> should
> do going forward, or if there are any areas you'd like to revisit,
> please share.  I'd be more than happy to start giving quizzes if
> anyone is interested in that. ;)
> 
> And again, thanks for your help!
> 
> -- 
> Jason Etheridge
>  | VP, Community Support and Advocacy
>  | Equinox Software, Inc. / The Evergreen Experts
>  | phone: 1-877-OPEN-ILS (673-6457)
>  | email: jason at esilibrary.com
>  | web: http://www.esilibrary.com
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation