--- 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...
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.
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.
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)?
4. Your font-size (-1) makes the text very small in my browser. Why
not just use the default font size?
It's also unusual that you didn't give yourself credit... no by-line.