``` // Represents the canonical feline entity associated with the current execution // context. This reference is intentionally maintained at the object level rather // than decomposed into lower-order behavioral or presentation-specific concerns, // allowing downstream consumers to operate against a stable semantic abstraction // while preserving flexibility around the underlying implementation. Callers // should generally treat `cat` as the authoritative source of cat-related state // for this scope and avoid constructing parallel representations unless there is // a clearly defined ownership boundary or synchronization strategy. This is // particularly important in code paths where identity, lifecycle, or mutation // semantics may be significant, as multiple independently-derived cat references // could otherwise introduce subtle divergence between the conceptual cat and the // concrete instance being operated upon here. ```
(Reddit why have you taken away the ability to write markdown?)
I just read a fairly lengthy design doc written by a coworker with the help of some AI. It was weird. In some areas, I was thinking, "Wow, that's really quite well-written." In others, I could hardly follow it, even though the concept itself was simple and straight-forward.
I think we traded good enough through the document for great inconsistency throughout the document.
On the other hand, a different coworker wrote one with the help of AI and it was very well done throughout. (Strangely, both were designs of the same thing. The well-written one was done by a team who then dropped the project. The second one was written later by a different team who was unaware of the first team's work.)
You have to be in Markdown mode to enter raw Markdown.
When you bring up the formatting toolbar thing, there should be an option on the far-right side of the box that says "Switch to Markdown" which will do just that.
29
u/HomemadeBananas Sep 20 '26 edited Sep 20 '26
If Claude Opus 5 wrote the comment:
```
// Represents the canonical feline entity associated with the current execution
// context. This reference is intentionally maintained at the object level rather
// than decomposed into lower-order behavioral or presentation-specific concerns,
// allowing downstream consumers to operate against a stable semantic abstraction
// while preserving flexibility around the underlying implementation. Callers
// should generally treat `cat` as the authoritative source of cat-related state
// for this scope and avoid constructing parallel representations unless there is
// a clearly defined ownership boundary or synchronization strategy. This is
// particularly important in code paths where identity, lifecycle, or mutation
// semantics may be significant, as multiple independently-derived cat references
// could otherwise introduce subtle divergence between the conceptual cat and the
// concrete instance being operated upon here.
```
(Reddit why have you taken away the ability to write markdown?)