| ▲ | bneb-dev 5 hours ago | |||||||
For complete transparency: AI augmented engineering is the core workflow for this project. I have been pretty diligent about trying to de-slop the project after long RALPH loops and `/goal` prompts, and I review and edit documentation. Based on your feedback, I just made another pass. Please feel free to let me know if there is anything specific lacking from the docs, and I will update them in the future. | ||||||||
| ▲ | skybrian 3 hours ago | parent [-] | |||||||
If you compare say, the Go language specification for an assignment statement [1] to Salt's explanation of its let statement, there is a big difference. Salt's docs lean heavily on "it works like you would expect from other languages" so you have to reason by analogy. A specification shouldn't work that way; it should actually explain the rules for each language construct, without assuming knowledge of other languages. | ||||||||
| ||||||||