# How to Write More Useful Bug Reports

DevFeed: [How to Write More Useful Bug Reports](<https://devfeed.tech/articles/it-s-not-working-36854.md>)

Original publisher: [Read original article](<https://shostack.org/blog/its-not-working/>)

Author: Adam

Published: 2020-11-25T00:00:00Z

Content type: opinion

Language: en

Sources: [Shostack & Friends Blog](<https://devfeed.tech/sources/shostack-friends-blog.md>)

Topics: [bug](<https://devfeed.tech/topics/bug.md>), [TLS (Transport Layer Security)](<https://devfeed.tech/topics/tls.md>), [Chrome](<https://devfeed.tech/topics/chrome.md>), [macOS](<https://devfeed.tech/topics/macos.md>)

Tags: [bug](<https://devfeed.tech/tags/bug.md>), [chrome](<https://devfeed.tech/tags/chrome.md>), [macos](<https://devfeed.tech/tags/macos.md>), [tls](<https://devfeed.tech/tags/tls.md>)

## AI overview

The article explains how to report technical problems more effectively, recommending that people describe what they did, what they observed, what they expected, and the impact. It uses TLS trouble encountered during the threat modeling manifesto launch as context and gives a Chrome on macOS example.

## Source excerpt

Help me help you...