ericyd
Joined 4 years ago
Joined 4 years ago
This line:
> Checked by a guardrail test, not just claimed.
Is such a meaningless statement to include in the marketing page, it immediately makes me feel like the entire effort was lazy because it seems like they didn't proofread their own page. I almost would rather they just have a page describing what they were trying to accomplish and the prompt they used to get there, and skip the ceremony of the generated library.
I hope this was written as tongue in cheek, otherwise wow, you are taking yourself too seriously.
The counter-argument i envision is: "update your docs and code at the same time in the same PR!" That works great, until you want to document something that isn't precisely tied to a single piece of code. In fact I think the most useful docs describe high level systems rather than being associated with specific pieces of code. Use comments for that; in contrast, docs should be easily editable by anyone at all times, otherwise they never get updated (an evergreen problem in any scenario).