---
title: "Why I don't document quirks of a feature on the feature itself."
url: https://daily.dev/posts/why-i-don-t-document-quirks-of-a-feature-on-the-feature-itself--f7bufbrne
source_url: https://blog.jooq.org/resisting-the-urge-to-document-everything-everywhere/
type: article
source: "JOOQ"
published: 2025-02-28T10:52:24.804Z
updated: 2025-02-28T10:52:52.356Z
tags: ["java", "sql"]
reading_time: 7
upvotes: 3
comments: 1
language: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Why I don't document quirks of a feature on the feature itself.

**[JOOQ](https://daily.dev/sources/jooq)** · 7 min read · 3 upvotes · 1 comments

## Summary

Product managers often face requests to document quirks within features. However, documenting unrelated features together adds noise and confusion. Instead, it's suggested to use platforms like Stack Overflow for specific user scenarios, allowing targeted solutions without overwhelming general documentation.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://blog.jooq.org/resisting-the-urge-to-document-everything-everywhere/>

## Community discussion

Top comments from developers on daily.dev.

**@randy** · 0 upvotes

> Lukas is 100% right here. And he's also pretty much guaranteed to answer your SO question, one way or another.

## Similar posts on daily.dev

- [Don’t just attend KubeCon \+ CloudNativeCon, Merge Forward your experience\!](https://daily.dev/posts/don-t-just-attend-kubecon-cloudnativecon-merge-forward-your-experience--l0rpp73x8) · CNCF · 0 upvotes · 0 comments
- [Announcing H2 2026 KCDs](https://daily.dev/posts/announcing-h2-2026-kcds-m96goajm1) · CNCF · 1 upvotes · 0 comments
- [Two months of Open Community Groups](https://daily.dev/posts/two-months-of-open-community-groups-asf52zhbs) · CNCF · 0 upvotes · 0 comments

---

Tags: [#java](https://daily.dev/tags/java), [#sql](https://daily.dev/tags/sql)

[View this post on daily.dev](https://daily.dev/posts/why-i-don-t-document-quirks-of-a-feature-on-the-feature-itself--f7bufbrne)