fostr/README.md

# The fostr programming language

I don't really like to write code, but I do like the things that coding can
build for me: accounting systems for non-profits I care about, spreadsheets
that have a reasonable calculation language for cell contents, geometric
visualizations that really help to understand three (and maybe even four!)
dimensions.

So I embarked on this project to see if I could produce as comfortable a
language as possible to work in, given that I inevitably will be doing a
bunch of coding. The language will be
organized around (unary) ++f++unctions, (binary) ++o++perators, and
(nullary) ++str++eams, hence the name "fostr".

Other guiding principles:

* Maximize signal to noise ratio in code, which means minimizing the number
  of symbols that have to be there just for the syntax; reducing punctuation;
  seeking brief syntax that is not too terse; etc.

* Since code is always structurally indented anyway, make use of that and
  don't repeat information that's in the whitespace. This principle meshes
  well with the previous one, and if whitespace significance is baked into
  the language design from the ground up, it can be kept both effective and
  natural.

* Code uses functions all the time. So needless to say, functions should be
  first-class entities that are exceptionally easy to create, pass around,
  etc.

* And true to the name, operators and streams should be just as easy to handle.

* Try to keep the constructs available as simple to reason about as possible,
  and practical to use. So side effects are OK, and it should be clear when
  they occur and in what order. And if possible, fostr will consist **only**
  of expressions, no other syntactic constructs. Everything has a value.

<!-- /md -->
Like just about every other language, this documentation begins with a
[whirlwind tour](http::/studioinfinity.org/fostr/basic).