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: i...@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

Reply via email to