Oil Language Docs

Related: Documentation Strategy

In Progress:

• Oil manual
  • this should be about oilrc and stuff ? And options? interactivity?

TODO:

• funcs and procs. And blocks! (first-class environments/namespaces)
  • Shell vs. Python composition.
  • 4 differences in signatures.
  • prefix spread ... at call site. Or "rest" parameters.
  • @ is "splice" at the call site. Or also "rest" parameters.
  • & block. TODO.
  • Optional types.
• Expression language. Maybe this is a diff vs. Python.
  • literals
  • operators
• Word Language Extensions
  • @array (reminder about array literals)
  • $strfunc(x, y)
  • @arrayfunc(x,y)
  • $[obj.attr] etc.
• Command langauge as a diff over OSH?
• Glossary?
• Oil Builtins
  • Changed: echo
  • New: push, etc.

Blog Posts

• You Can Try the Oil Language
• Oil language from 1M Feet
  • Shell, Python. JS, Ruby, etc.
  • Link to deferred features ? Future direction is R.
• Oil Language from 10,000 feet

Done:

• Eggex Doc

Not ready:

• Data Frames
• Data Model: Unifying value and PyObject