Here's a good example of how I like to use issue threads. The issue opens with a description that includes relevant linked code snippets, documents some design decisions and micro-research I performed, includes the commit that fixes the issue, links to the docs and shows some follow-up work before linking to the release that incorporated the changes Goal is to tell the full story of the problem and its solution so I can fully understand it when I revisit much later https://github.com/simonw/datasette/issues/2277