search

alda-lang / alda.io

The official Alda website
https://alda.io
4 stars 10 forks source link

Docs: Example scores #19

Open daveyarwood opened 7 years ago

daveyarwood commented 7 years ago

See #8 for context.

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.

Another great idea from @abhi18av:

Also I feel we need to expand on the examples to something more like a gallery.

I think an "Example Scores" section would be nice. We could adapt the example scores in the alda-core repo and come up with a cohesive set of examples that serve as good demos for Alda's features.

The example scores in the alda-core repo are used for automated testing, so many of them are not really the best demos. We should think about which ones to include and possibly about adding additional examples.

EDIT 2024-03-19: updated example scores link

KyriAgiak commented 6 months ago

Hello, I was wondering if i can work on this. I could also try to transcribe some popular pieces and add them as examples?

daveyarwood commented 6 months ago

@KyriAgiak Thanks, any help would be appreciated!

What I'm really looking for is a page with a handful of high quality examples showcasing the strengths of Alda. The scores could either be shown inline on the page, or we could link to them, whatever ends up looking best, presentation-wise.

These examples could be taken from / adapted from the ones in the repo, or you could write some new ones if you feel inspired.