Documentation

[kwijibo]

I realise this lib is very very young, but I'm looking forward to even the briefest documentation explaining the concepts (beyond view over and set)

[DrBoolean]

Might have already seen, but all i have so far is this: https://medium.com/@drboolean/lenses-with-immutable-js-9bda85674780

[polytypic]

@kwijibo I hope you don't mind my intrusion, but if you are interested in documentation that might help you to understand the scope and utility of optics, then my optics library, partial.lenses, has fairly thorough documentation. The library provides similar concepts, namely isomorphisms, lenses, and traversals, but with somewhat different, partial, semantics. My library also differs somewhat from this library in that my library doesn't explicitly provide some related concepts such as prisms, folds, setters and getters. Where appropriate, those are instead treated as degenerate forms of partial isos, lenses and traversals and despite not having those concepts explicitly, the expressive power seems comparable. The documentation is also provided in an interactive form where you can edit code samples in your browser and immediately see the result. The page can take quite some time to load due to the large number of editable snippets: https://calmm-js.github.io/partial.lenses/