Skip to content

Docs: Better landing page #11

Description

@daveyarwood

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.

Quoting myself:

I made a quick sketch of what these sections might look like:

From the landing page, sections could include:

  • What's new in Alda 1.0.0? (1.1.0, 1.2.0, etc.)
  • Setup and Usage
  • Tutorial (see below)
  • Reference (would include things like...)
  • The Alda Command-Line Client
  • Developer Portal (would include information like...)
    • Using Alda in a Clojure program
    • Technical details about Alda components
    • Writing your own Alda components
    • ZeroMQ architecture
  • Community (links to the Alda Slack group, subreddit, GitHub org, etc. and information about contributing to Alda)

Quoting @abhi18av:

@daveyarwood Let's include the your talk videos in the docs.

Alda: A Music Programming Language, Built in Clojure (David Yarwood)

Alda: A text based music composition language

I think we could also include a "Talks and Demos" section where we could include links to the videos above, as well as this excellent demo by @jimcheetham.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions