3 ms·
The answer is exactly on you question. Code is detailed. It need to has every implementation detail, a spec is high level view demoted of all unnecessary detail
by cclacerda13 7mo ago
The answer is exactly on you question. Code is detailed. It need to has every implementation detail, a spec is high level view demoted of all unnecessary details!
- kikkupico 7mo agoWhat do we gain by maintaining a high level view instead of asking an LLM to explain the code at a high level when required?
- cclacerda13 7mo agoIt captures the why and what of the system from a business or user perspective. Existing code don't inherently capture the original business problem or design choices that led to that code.
- kikkupico 7mo agoFair enough! Business and user perspectives are meta-data that explain the intent behind the code. I disagree with the point that intent should be the source of truth, though. Intent, like you explained, is high level and lacks the details to be an unambiguous source of truth.