Monorail’s mission is to track issues to help improve software products. Every piece of information stored in Monorail’s database is contributed from a user to one of the projects that we host for the purpose of helping developers work on that project. Issue tracking covers many different development processes, including fixing defects, organizing enhancement requests, breaking down new development work into tasks, tracking operational and support tasks, coordinating and prioritizing work, estimating schedules, and overseeing new feature launches.
Flexibility: Monorail is unusually flexible, especially in its use of labels and custom fields. This allows large projects to include several small teams, some of which care about labels and fields that are specific to their own processes. Flexibility also enables process changes to be gracefully phased in or phased out over the long term.
Security: Even open source projects need access controls so that developers can work to resolve security flaws before disclosing them. Per-issue access controls allow developers to work closely with users and partners on a mix of public and restricted issues.
Inclusiveness: Computing is an empowering and equalizing force in society. Monorail’s inclusive functionality and user interface can help many different stakeholders influence the future of a project, causing ripple effects of inclusion through our software ecosystem.
A Monorail server is divided into projects, such as /p/chromium
and /p/monorail
, that each have a list of project members, and that contain a set of issues. Each project also has a page that lists the history of issue changes, and a set of pages that describe the software development process configured for that project.
Each issue has metadata such as the issue summary, reporter, owner, CC'd users, labels, and custom fields. Each issue also has a list of comments, which may each have some attachments and amendments to the metadata.
Each user also has a profile page and related pages that show that user's activity on the site, their saved queries, and their hotlists.
Please search for relevant existing issues before entering a new issue.
New issue
button at the top of the page. Note: In the /p/chromium
project, non-members will be redirected to a new issue wizard.Most issue types are public or could become public, so don't include personal or confidential information. Be mindful of the contents of attachments, and crop and redact screenshots to avoid sharing unintended details. Never include passwords.
When you report an issue, you star the issue by default. Starring causes you to get email notifications of comments on that issue.
It is also possible to enter issues by clicking on a “deep link” to our issue entry page. Such links are sometimes used in documentation pages that tell users when to file an issue.
A menu at the end of the search box input field offers links to the advanced search page and the search tips page.
You can jump directly to any issue by searching for the issue’s ID number.
If you need to delete a comment that you posted, use the “...” menu for that comment. Attachments can also be marked as deleted.
It is also possible for project members to bulk edit multiple issues at one time, and to update an issue by replying to some issue update notifications.
If you need a URL that you can bookmark or paste into another document:
You can copy and share the URL of the issue as it is shown in the browser location bar.
For a cleaner link, open the browser context menu on the link icon located next to the issue summary, then choose “Copy Link Address”.
If you are writing text in an issue comment, you can make a textual reference to another issue by typing the word “issue” or “issues”. For example:
There are several ways to get notifications:
Click the star icon at the top of the issue to express your interest in seeing the issue resolved and to be notified of future updates to the issue. Or, click the star icon for that issue in the issue list.
The issue owner and any CC’d addresses are notified of changes.
You can subscribe to a saved query. Start by clicking the “Saved queries” item in the account menu.
If you wish to file a bug against Monorail itself, please do so in our self-hosting tracker. We also discuss development of Monorail at infra-dev@chromium.org
.
You can report spam issues via the “...” menu near the issue summary. You can report spam comments via the “...” menu on that comment. Any project owner can ban a spammer from the site.