← Back to Contribute Community help

How to open an issue

Found something broken? Have an idea for the site? You do not need to know how to code. Opening a GitHub issue is the easiest way to tell the maintainers what should change.

Before you start

You only need two things

01

Go to the project on GitHub

Open the Decision Management Community repository, then choose the Issues tab near the top of the page.

Go straight to Issues ↗
github.com / Decision-Management-Community / dm-community
CodeIssues 27Pull requestsActionsProjects
Click Issues
02

Click “New issue”

On the Issues page, click the green New issue button. If GitHub asks you to sign in, sign in or create a free account.

Issues · dm-community
Website suggestion#123 opened recently
Click New issue
03

Write a clear title

Use one sentence that tells us what needs attention. Good titles are specific enough that someone can understand the problem without opening the issue.

Good: Broken link on the Resources page Good: Add author filtering to Articles Avoid: Website problem
New issue · dm-community
Broken link on the Resources page
Tell us what happened…
Be specific
04

Explain what you saw and what you expected

You do not need technical language. Just give enough context that another person can reproduce the problem or understand the suggestion.

  • Which page were you on?
  • What did you click or try to do?
  • What happened?
  • What did you expect instead?
  • If useful, attach a screenshot.
New issue · dm-community
Page: Resources

What I did: Clicked the “Optimization tools” link.

What happened: It opened a 404 page.

Expected: The tool page should open.
📎 Attach a screenshot by dragging it here
05

Submit the issue

Give your description one quick read, then click Submit new issue. That is it. A maintainer can now discuss, prioritize, or fix it in public.

You can come back later to add more detail or answer questions in the issue thread.

New issue · dm-community
Your description is ready.
Click to send it
Copy this structure

A simple issue template

Page or area: [Where did you see the problem?]

What I did: [What did you click or try?]

What happened: [Describe the result.]

What I expected: [What should have happened instead?]

Extra context: [Screenshot, browser, idea, or anything else helpful.]

That’s all there is to it

See something? Tell us.

Small fixes, confusing pages, broken links, new ideas, missing resources — issues are welcome.

Open an issue now