The Yamaha AN1x Synthesizer mailing list

--- In AN1x-list@yahoogroups.com, "Kevin Conder" <kwconder@y...> 
wrote:
> --- In AN1x-list@yahoogroups.com, "Jon" <jondl_2000@y...> wrote:
> 
> > A working copy of the new AN1x Control Synthesizer FAQ 
> > is now online:
> > http://www.geocities.com/jondl_2000/an1x_faq/an1x_faq_toc.htm
> > 
> > If you would like to contribute or suggest improvements 
> > to the AN1x FAQ, please send an email with your comments
> 
> Well, since you asked...
> 

Yes, indeed I did - thanks for taking the time.

> 1. You're missing licensing information, not even a copyright. How 
may
> someone legally redistribute your work? Can someone legally modify 
it
> or create a derivative work: translations, reformatting, fixing 
typos,
> etc.?
> 
> I suggest a free documentation license like the GNU Free 
Documentation
> License (without invariant sections) or a Creative Commons license
> (without a non-commercial restriction):
> * http://www.fsf.org/licenses/licenses.html#FDL
> * http://creativecommons.org/license/
> 
> If you choose one of those suggested licenses, I'll convert the FAQ 
to
> DocBook/XML. It can then be rendered to ASCII, HTML, and PDF.
> 

Thanks for the links - I really didn't licensing much thought 
beforehand.  I've considered converting the doc to other formats but 
wasn't much bothered by it on this draft.

> 2. The "other points of reference" part of the preface is confusing,
> IMHO. It looks like those external links are part of the FAQ. I'd 
move
> them to an appendix or their own section.
> 

Okay, I see your point and yes, it is kind of awkward isn't it?

> 3. How about categorizing the questions? I think this will become 
more
> important as the FAQ grows. How about these categories: meta-info
> (about the FAQ itself and AN1x-list), MIDI, hardware (sub-sections:
> AN1X, AN200, PLG150-AN), and software (sub-sections: AN1xEdit-Mac,
> AN1XEdit-Windows, Other)?
> 

I'd considered this when finishing the HTML and opted to include 
categories for the next revision. Keep in mind this FAQ applies to a 
7 year old instrument and it's siblings - it's not going to grow 
much. I've initiated correspondence with a number of related mailing 
lists and I'm hopeful to gather some additional info - PLG150-AN & 
AN200 specific - which will find it's way into the FAQ.

> 4. Your font-size (-1) makes the text very small in my browser. Why
> not just use the default font size?
> 

I've only tested in four browsers and this had not been in a problem, 
but I'm familiar with the symptom you describe.

> It's also unusual that you didn't give yourself credit... no by-
line.

Well, I DID credit the AN1x-list ;-)

Jon