swarm-game / swarm

Resource gathering + programming game
Other
837 stars 52 forks source link

Swarm language reference #1520

Open byorgey opened 1 year ago

byorgey commented 1 year ago

It would be nice to have some documentation (perhaps on our new website) that lays out the syntax, semantics, and type system of the Swarm language. Some of this information is sort of contained in tutorial descriptions, but they are incomplete and hard to use as a reference.

Note, the new language reference does not need to include a list of all commands --- we already have a wiki cheat sheet for that. It just needs to describe the base language.

kostmo commented 1 year ago

Perhaps a syllabus (#1199) would also be applicable.

byorgey commented 1 year ago

The reference info on the world function DSL (currently in data/worlds/README.md) and JSON schemas could also be hosted in the same place.