Closed david-garcia-nete closed 5 years ago
Thanks for your interest in the user manual. One of the major goals of the user manual is to present content in a way that both tells users what components are as well as providing the context, examples, and tutorials for how/why to use certain components.
One aspect of that is teaching users how components of a synthesizer work together, however teaching users the general concepts of synthesizers is not a primary goal. There are other resources that are going to accomplish the goal of teaching broad concepts better than would be done in the scope of this document and making that a goal would expand the scope of the user manual considerably.
Limiting the scope of the user manual (and of software projects themselves) helps make it more feasible to provide a structurally sound and maintainable project.
For more information I'd recommend seeing the targets outlined in https://github.com/zynaddsubfx/user-manual/blob/master/Goals.adoc and the structure put forth in https://github.com/zynaddsubfx/user-manual/blob/master/Introduction.adoc
You’re welcome. Thanks for the reply. You’re right. I was looking at the ZynAddSubFX code and the older user manuals today. It is taking me some time to understand Zyn-Fusion but I’m making steady progress. When I grasp the concepts better I may create some pull requests here.
I completed the generic Syntorial course (https://www.syntorial.com/) as well as the lesson packs for Serum, Massive and Sylenth. The generic course helped me understand synthesizers in general and the lesson packs helped me understand these popular synth models.
I suggest that the Zyn-Fusion user manual follow a similar organization of material. What is here is great because it is specific to Zyn-Fusion. However, a student who is trying to learn the synthesizer may want to know first how Zyn-Fusion handles the roles of a generic synthesizer before learning about the features that are specific to Zyn-Fusion.
I suggest creating a new page that outlines the generic features of a synthesizer and links to pages on how to achieve the sound in Zyn-Fusion. The generic lessons from the Syntorial course are listed below.
The synthesizer lesson packs have one additional video from each section followed by videos specific to the synthesizer. This would be a good model for the Zyn-Fusion manual. Additionally I think this manual should have tutorials on creating instruments and sound effects. I think Syntorial should have a Zyn-Fusion lesson pack but that would be impossible without a proper Zyn-Fusion user manual.