Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Tutorial #10

Open
daveyarwood opened this issue Feb 1, 2017 · 1 comment
Open

Docs: Tutorial #10

daveyarwood opened this issue Feb 1, 2017 · 1 comment

Comments

@daveyarwood
Copy link
Member

daveyarwood commented Feb 1, 2017

See #8 (comment) for context.

The tutorial sections could be something like:

  • Anatomy of an Alda Score (a broad overview of the structure of a score file, explaining instrument parts, variable definitions, etc. without going into too much detail)
  • Notes and Rests
  • Chords and Voices
  • Grouping Instruments (covers instrument groups and naming instruments/groups)
  • Attributes
  • Advanced Rhythms (covers second/millisecond durations and CRAM notation)
  • Using Variables
  • Generating Music by Writing Code (covers inline Clojure code and an overview of the alda.lisp DSL)

This is just a quick sketch; I'm definitely open to any suggestions about how to tweak this, but maybe this outline can be a good starting point.

This should be done by modifying the docs folder in alda-lang/alda. The docs are kept in sync with releases and used to generate http://alda.readthedocs.io, which will be CNAMEd to docs.alda.io.

@daveyarwood
Copy link
Member Author

NOTE: There is already the "official" tutorial on the Alda website, but I think it would be great to have a revamped tutorial broken down into sections, with a sidebar, with better explanations and more examples. The current tutorial also does not cover some of the more advanced concepts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant