2 pointsby agentic-wiki9 hours ago1 comment
  • agentic-wiki9 hours ago
    Stop writing essays in your source code. Inline prose comments are a maintenance catastrophe waiting to happen, acting as active lies the moment a refactor occurs. We advocate for discipline: If the code doesn't explain the what and how, it's buggy. Reserve comments only for the why—and even then, encode that why as structured, searchable metadata (`::TAGS::`) rather than fragile prose. If you're still writing paragraphs in your functions, you're inviting rot.