[OPEN-ILS-DOCUMENTATION] Need help with proofreading some EG 2.4 documentation

Yamil Suarez ysuarez at berklee.edu
Tue Aug 6 11:30:32 EDT 2013


On Aug 6, 2013, at 11:03 AM, Dan Scott <dan at coffeecode.net> wrote:
> 
> Crazy idea to avoid bottlenecking, depending on how many files we're
> talking about: 
> 
> 1. Push the draft docs into a git working "collab" branch
> 
> 2. Put up a wiki page linking to each file (git version and HTML
> version), and let people edit the wiki to show that they're working on /
> have finished proofreading each file.
> 
> 3a. If the proofreader also has the skills to push changes to git,
> then they can push their changes to the collab branch
> 
> 3b. Otherwise, they could add comments to the wiki page to indicate
> where changes need to happen, and then someone who may not be yboston
> would be able to make those changes
> 
> Seem doable?
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation


For the record, I have about 28 individual Asciidoc files with 28 matching HTML files (plus images).

I don't know if this approach will be worth it if I only have one or two people helping me, compared to the time it will take me to set it up. Also, I will probably be the only one that is using Git in this group. I am still a Git newbie, and it is great to see ways that source control can be leveraged, while taking advantage of current community practices, to make our lives easier. I will keep this approach in mind for future use. 

Does that make sense?

Thanks,
Yamil 


More information about the OPEN-ILS-DOCUMENTATION mailing list