Hi DIGers,

This is just to note that the master home repository for the documentation has 
officially changed to (as of last week):
http://git.evergreen-ils.org/?p=Evergreen-DocBook.git;a=summary

However, the github repository  will be synchronized with the master repository:
https://github.com/rsoulliere/Evergreen-DocBook/

We will continue to work with the github repository to take advantage of some 
of its features especially the web interface which allows online updates to the 
repository.

This brings me to a question about approaches with 2 possibilities:

1) Centralized repository approach where users work in the main repository with 
some forking taking place on an individual request basis. -- kind of how it 
works now.

2) Decentralized "forked" teams approach where we have official github forks 
based on content parts of the documentation. E.g. Someone maintains a fork for 
the Admin team and another person maintains a fork for the OPAC team, etc... 
These forks will then be merged  into the main repository at 
http://git.evergreen-ils.org/?p=Evergreen-DocBook.git and the main github fork 
at https://github.com/rsoulliere/Evergreen-DocBook/. These merges will take 
place at least daily if not several times a day.
Now it is possible for individuals to create their own forks and send pull 
requests to me to merge into the main repository. However, my goal here is to 
not have a lot of manual pull requests but to have an automated merging of the 
trusted team forks into the main repository on a schedule. The other advantage 
of these team forks is that it could, perhaps, encourage collaboration among 
teams working on various parts of the documentation. Then there is the argument 
that this approach takes fuller advantage of the git "decentralized version 
control system" features.
This second approach does not affect the procedures for contributing 
documentation. It really only effects "where" they will contribute.

Any ideas questions, comments, other suggestions?

Regards,
Robert

Robert Soulliere, BA (Hons), MLIS
Systems Librarian
Mohawk College Library
[email protected]
Telephone: 905 575 1212 x3936
Fax: 905 575 2011

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
[email protected]
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

Reply via email to