[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Google Season of Docs

From: Urs Liska
Subject: Re: Google Season of Docs
Date: Mon, 8 Apr 2019 01:12:28 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1

Am 06.04.19 um 01:49 schrieb Kieren MacMillan:
Hi Werner,

Would this be of interest for LilyPond?
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.



Kieren MacMillan, composer
‣ website:
‣ email: address@hidden

lilypond-devel mailing list

reply via email to

[Prev in Thread] Current Thread [Next in Thread]