Editorial starter example. Original guide created for the Devex launch; not research, a user testimonial, or a report of community activity.
A screenshot can spark curiosity. Context turns it into a conversation. A useful project post lets others understand the problem, what you learned, and which feedback would help.
Start with the problem and the user
Explain who the project is for and when it helps. If it is a personal experiment, say so. Do not turn an idea into an adopted product or a few attempts into user research.
Show the main path
Describe one action from its beginning to the result. A demo or repository link can help when you are allowed to share it. Explain any account, test data, or installation requirements, and avoid publishing real credentials.
Choose one decision to explain
Instead of listing every technology, describe a meaningful tradeoff: why you stored data locally, how you limited an agent’s permissions, or why you chose a particular test. Explain what you would choose differently in another context.
Separate what works from what remains open
Distinguish a prototype, a locally tested result, and a feature running for users. Describe your checks and remaining work. If you used AI, explain where it helped and where you had to intervene.
A community post template
What I built: [one sentence] Who it helps and why: [context and problem] How it works: [main user path] An interesting decision: [choice and tradeoff] What I checked: [environment and scenarios] What remains open: [limitations] My connection to the project: [personal/work/commercial] I would like feedback on: [focused question]
Replace the brackets with real information before publishing. This is an example template, not a description of a project completed in the community.
Discuss: Which decision in your last project seemed small at first but turned out to matter?