Reporting Issues

Go to the sign-up page

Open github.com/signup in your browser.

Enter your details

Provide an email address, a password, and a username. GitHub will send a code to your email to confirm it's really you.

Verify and finish

Enter the code from your email. That's it — you now have a GitHub account and can create issues.

Open the issues page

Go to the project's issue tracker: github.com/unicef/adt-studio/issues.

Search first

Type a few keywords into the search box to check whether someone has already reported the same thing. If you find a matching issue, add a comment or a 👍 reaction instead of opening a duplicate — it helps the team gauge how many people are affected.

Choose a template

Click the green New issue button. You'll be asked to pick the template that matches what you're reporting — choose the closest one:

• Bug Report — something isn't working the way it should.
• Feature Request — suggest a new feature or improvement.
• Accessibility Issue — report an accessibility barrier in the app or in a book it produced.
• Documentation Issue — something in these docs is wrong, unclear, or missing.
• Question / Support — ask how to do something in ADT Studio.

Fill in the form

Each template is a short form that asks for exactly what the team needs, so just follow the fields. A few tips for a report that's quick to act on:

• A clear title — summarize it in one line (e.g. "Audio fails to generate for Portuguese").
• What happened vs. what you expected.
• Steps to reproduce it — what you clicked, in order, so the team can see it too.
• Your setup — your operating system (Windows, macOS, or Linux) and the ADT Studio version.
• Screenshots or a screen recording — drag image files straight into the text box. A picture often explains more than a paragraph.

Submit

Click Submit new issue. You'll get an email whenever someone responds, and you can reply right from your inbox or on the issue page.