News for hackers. Stuff that matters.
Re:Dhall: A Gateway Drug to Haskell by axman6 on Sunday June 19, 2022 @12:05PM (#31800583)
This argument is literally “the documentation for this domain I don’t understand is bad because I refuse to learn the domain”.

I use the lens library all the time and those docs make perfect sense, particularly if you apply just the teensiest bit of logic and thing “Could a setter, perhaps, set something?”. It’s a DSL, and you don’t understand the domain - I’m sure you’d have a great time explaining this function from LLVM without referring to any other part of the documentation to give it context https://llvm.org/doxygen/group__LLVMCCoreValueInstructionGet.... What’s a GEP? Under the rules you’re applying to the lens documentation, I’m not allowed to look that up, because it should be immediately obvious.

Re:Dhall: A Gateway Drug to Haskell by spion on Tuesday June 21, 2022 @07:29PM (#31830323)
Yes they actually document which bit is what

> Get the source element type of the given GEP operator

Notice the relentness repetition that provides precision and clarity? I now know the argument GEP is a GEP operator. Might seem redundant, but it allows a new reader to start from any point and find their way to the relevant terms / nouns and their types.