[prev in list] [next in list] [prev in thread] [next in thread]
List: lilypond-devel
Subject: Re: Google Season of Docs
From: Urs Liska <lists () openlilylib ! org>
Date: 2019-04-07 23:12:28
Message-ID: 6f51b8f3-56b7-0efe-6c78-3dea8ac1c915 () openlilylib ! org
[Download RAW message or body]
Am 06.04.19 um 01:49 schrieb Kieren MacMillan:
> Hi Werner,
>
>> Would this be of interest for LilyPond?
>> https://developers.google.com/season-of-docs/docs/project-ideas
> It would be *very* valuable for OpenLilyLib… =)
Indeed, but I don't think this program is suitable for that ...
If I've understood the program correctly it is targeted at "technical
writers" who should be able to write about an arbitrary subject. The
first thing is that "we" would need writers with very specific prior
knowledge (LilyPond and Scheme), and the major issue is that openLilyLib
would rather need a fundamental *infrastructure* for *generating*
documentation. Which is a programming challenge, not one about writing,
and consequentially we have it listed on the GSoC project ideas page.
I think the general LilyPond documentation would be much more suitable.
Here we have an abundance of existing texts, and it would be very useful
to review much of that from the perspective of technical writing, i.e.
improving the understandability by thinking more about the target reader
than the underlying technical foundation.
Urs
>
> Cheers,
> Kieren.
> ________________________________
>
> Kieren MacMillan, composer
> ‣ website: www.kierenmacmillan.info
> ‣ email: info@kierenmacmillan.info
>
>
> _______________________________________________
> lilypond-devel mailing list
> lilypond-devel@gnu.org
> https://lists.gnu.org/mailman/listinfo/lilypond-devel
_______________________________________________
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic