Alda: The Docs™
Hello! I'm an introductory paragraph, and this is the landing page for Alda's official documentation. If you've come here to learn more about Alda and how to use it to write amazing musical scores, READ ON!
Useful Links
- README
- Contributing to Alda
- Development Guide
- CHANGELOG (Version History)
- Some background on Alda and a tutorial
Where to Start
-
Learn about the etymology behind the name Alda.
-
The article on scores and parts provides some good general information on what an Alda score is. After that, you may be interested in learning more about the fundamental pieces of an Alda score:
- notes
- rests
- chords
- voices
- markers
- offset
-
Peruse this list of available instruments.
How to Use the Docs
Alda's documentation is a (mostly) interconnected collection of Markdown files that serve as the "official manual" to Alda: the definitive guide to how to do all the things you want to do in an Alda score.
In as many places as it makes sense to do so, relative links are included from one document to another. It's a lot like a wiki; it is versioned and maintained by the maintainers of the Alda project itself, with help from the community (that's you!). Alda's documentation is a perpetual work-in-progress, and a collaborative effort in which anyone can take part.
If you're one of those know-it-all types who likes to know everything about everything, then you may want to browse the entire docs folder. Or, you can just pick an article and start reading, click whatever links catch your eye, and see where the night takes you. Whatever you wanna do, man -- I won't judge you; I'm just a landing page.
If, in the course of reading these docs, you stumble upon something that you think could be improved (even if it's just a tiny little typo), you notice that some information is incorrect or missing, or you're just plain confused about something, please feel free to submit a Pull Request or file an issue to help us improve our documentation. Don't be shy!