Musicians' Guide Progress.

[Christopher Antila]

On 07/28/2010 08:46 AM, docs-request at lists.fedoraproject.org wrote:
> Subject:
> Fwd: [musicians-guide] added many chapters
> From:
> "Eric \"Sparks\" Christensen" <sparks at fedoraproject.org>
> Date:
> Wed, 28 Jul 2010 08:46:30 -0400
> 
> To:
> For participants of the Documentation Project <docs at lists.fedoraproject.org>
> 
> 
> Crantila,
> Are you ready to push this to docs.fp.o so we can all see how it's going?
> 
> --Eric
> 
> 
> ---------- Forwarded message ----------
> From: crantila <crantila at fedoraproject.org>
> Date: Wed, Jul 28, 2010 at 02:27
> Subject: [musicians-guide] added many chapters
> To: docs-commits at lists.fedoraproject.org
> 
> 
> commit 4447fcd58d2f37b6acd03e1936df9194e3a8a5dd
> Author: Christopher Antila <crantila at fedoraproject.org>
> Date:   Wed Jul 28 02:27:12 2010 -0400
> 
>    added many chapters
> 
>  en-US/Book_Info.xml                  |    6 +-
>  en-US/Digital_Audio_Workstations.xml |  244 ++++++++++++++++++++++++++++++++++
>  en-US/Musicians_Guide.xml            |    9 +-
>  en-US/Planet_CCRMA_at_Home.xml       |  139 +++++++++++++++++++
>  en-US/Real_Time_and_Low_Latency.xml  |   77 +++++++++++
>  en-US/Sound_Cards.xml                |  129 ++++++++++++++++++
>  en-US/Sound_Servers.xml              |  141 ++++++++++++++++++++
>  7 files changed, 741 insertions(+), 4 deletions(-)


Hi Eric and others:

I'm not really sure what's expected of a draft that makes it onto the
website, but here's my plan for completion:

28 & 29 July: transfer wiki draft into DocBook on git, almost verbatim,
links and most formatting still in MediaWiki format, etc.

30 & 31 July: days off; yes, this is Friday & Saturday.

1 & 2 August: take care of already-known errors/mistakes/deficiencies.

3 August: partial day off? Probably good time to post a draft on the
website here.

4 - 8 August: establish consistent style* and complete
MediaWiki->DocBook formatting

9 August: Fedora Summer Coding completion date

after that:
-make sure the supplementary materials are ready, including
diagrams/infographics (hopefully somebody can help me with that - Ryan
Lerch? :D ),
-scores and source files for LilyPond,
-source files and audio recordings for SuperCollider,
-audio materials for Ardour, Rosegarden, and Qtractor.

If there's time before the F14 branch (31 August?), I'd like to read
everything again after the deadline, because some of this stuff is
currently in need of serious help (Solfege  & Rosgarden in particular),
and one stage of revision might not do it.  We'll see if there's time,
depending on what real life has in store.

* The "Consistent Style" is going to be applied as per the Apple Style
Guide.  I chose this because I like the style/feeling of their
documentation, because I'm already somewhat familiar with it, and
because, of the major style guides for software documentation, this
Guide's target audience is most likely to be familiar with that one.
Mac OS X is, after all, the OS of choice for Creative People(TM).

Finally, the project's schedule has always been posted here:
https://fedoraproject.org/wiki/User:Crantila/FSC/Schedule

... but it was still at the beginning of July until about two minutes
ago.  I'll keep this updated now, I promise!


The original question was whether I'm ready to post a draft to the
website, and the answer is: "No.  Do it next Tuesday."


Christopher.