[OPEN-ILS-DOCUMENTATION] Fwd: [Announce] Call for Proposals for Doc Sprint Summit v2.0

Dan Scott dan at coffeecode.net
Thu Oct 18 16:17:05 EDT 2012


On Thu, Oct 18, 2012 at 07:11:38PM +0000, Duimovich, George wrote:
> 
> I'd suggest the group focus on the core documentation (gaps + polish),
> rather than making something completely new for the purpose of the
> event. There are enough gaps to fill that can be considered "new"
> documentation if "new" is what's required.

I would be tempted to try and stick to the terms of the call for
proposals; Google / FLOSS Manuals presumably wants to be able to say "We
created X new books!" rather than "We updated / filled in gaps in
existing documentation!". (That's pure conjecture on my part, not based
on any inside knowledge.)

In that vein, Robert's suggestion for a getting started guide would be
an appropriately-sized standalone project that would also be able to be
integrated into our existing documentation after the fact. I think that
would have particular value if there was also a focus on the "Getting
started with a production system" section; in the IRC channel we've
noted that there are all kinds of knobs to tweak and tune that new sites
trip over. It would be a real win to come away with a book that closes
that gap.


More information about the OPEN-ILS-DOCUMENTATION mailing list