Home - graeme-lockley/experiment-safe-language GitHub Wiki

Welcome to the experiment-parser-js wiki!

This wiki captures the thinking and rationale as well as technical detail that is pertinent to understand the code and its evolution.

Grammar

  • [V1 Grammar](v1 grammar)
  • [V3 Grammar](v3 grammar)

Library Principles

The following is a list of principles to be adhered to with respect to libraries:

  • Do not use shortened names unless they are universal - for example use Integer rather than Int and RegularExpression rather than RegEx
  • If a module requires a companion JavaScript module then, by convention, the module's companion has the same name expect it has the suffix Helper. For example List will have the companion ListHelper and Integer has the companion IntegerHelper.
  • Assumptions to be used to validate that the functions behaves as expected and are properly tested.