Document issue tracking process
This approach has some parallels with the approach applied by Googlers
working on Gerrit Code Review, in particular the definitions used to
apply Priority-[0-4].
Change-Id: Ie3a02b1881920947fac1909f529f406f1ff9e5cb
diff --git a/issues.md b/issues.md
new file mode 100644
index 0000000..f7f695e
--- /dev/null
+++ b/issues.md
@@ -0,0 +1,96 @@
+# Issue Tracking
+
+[Issues][list] are tracked at bugs.chromium.org.
+
+[list]: https://bugs.chromium.org/p/gerrit/issues/list?can=2
+
+[TOC]
+
+## Status
+
+Issues that do not have a contributor actively working on them may be
+in one of three states:
+- *New*: issue has not had initial review yet.
+- *AwaitingInformation*: issue needs more detail attached.
+- *Accepted*: problem reproduced or feature request acknowledged.
+
+Issues being worked on should change the status to let others know it
+may be resolved in the near future:
+- *Started*: a contributor has begun work on this issue.
+- *ChangeUnderReview*: a change for this issue been uploaded for
+ code review.
+
+Closed states resolve an issue:
+- *Submitted*: a fix has been submitted to a stable branch or the
+ master branch and will be included in a future release.
+- *Released*: a release has been announced including this fix.
+
+## Priority
+
+| Priority | Response | Resolution |
+|-------------------|--------------|----------------|
+| [Priority-0][p0] | | "soon" |
+| [Priority-1][p1] | | |
+| [Priority-2][p2] | 3 months | best effort |
+| [Priority-3][p3] | 6 months | best effort |
+| [Priority-4][p4] | 12 months | best effort |
+
+### Priority-0
+- Critical issue causing failures in production.
+- Major functionality broken that renders a feature unusable.
+
+### Priority-1
+- Urgent; the issue is blocking a user from getting their job done.
+- Breakage blocking next release (e.g. Guice injectors).
+- Defect causing functional regression in production.
+- Production issue impacting customers.
+
+### Priority-2
+- Work tied to roadmap, or near term upcoming release.
+- Inconvenient bug that should be addressed in one of the next few
+ releases.
+
+### Priority-3
+- We feel your pain: the team would like to fix this, but lacks the
+ resources to do this soon. Gerrit is an open source project;
+ contributions are appreciated.
+- Desirable feature or enhancement *not* on the roadmap.
+
+### Priority-4
+- Ponies and icebox.
+- Unfortunate: it's a legitimate issue, but the team never plans to
+ fix this.
+
+## Type
+- *Type-Bug* is broken functionality.
+- *Type-Feature* is a request for new feature or enhancement.
+
+## Component
+
+### PolyGerrit
+The new web interface built in Polymer. Issues in this component are
+actively managed by PolyGerrit maintainers involved in the daily
+development efforts.
+
+### NoteDb
+Related to the change metadata in Git project, which is migrating
+Gerrit off the SQL "ReviewDb" database.
+
+### googlesource
+Issue is unique to the `googlesource.com` family of servers, including
+gerrit-review.googlesource.com. This covers both administration
+support required (e.g. correct a broken user account) and issues
+unique to the server's plugins (e.g. authentication/web sessions or
+secondary index).
+
+### plugins
+Issues for a plugin project hosted under [plugins/][plugins].
+Actively developed plugins may have their own subcomponent.
+
+[plugins]: https://gerrit.googlesource.com/plugins/
+
+[p0]: https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=Priority%3D0
+[p1]: https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=Priority%3D1
+[p2]: https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=Priority%3D2
+[p3]: https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=Priority%3D3
+[p4]: https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=Priority%3D4
diff --git a/navbar.md b/navbar.md
index 18dfefb..174d354 100644
--- a/navbar.md
+++ b/navbar.md
@@ -3,7 +3,7 @@
* [About](/about.md)
* [Downloads](https://gerrit-releases.storage.googleapis.com/index.html)
* [Documentation](https://gerrit-documentation.storage.googleapis.com/Documentation/2.12.3/index.html)
-* [Issues](https://bugs.chromium.org/p/gerrit/issues/list)
+* [Issues](/issues.md)
* [Wiki](https://gerrit.googlesource.com/homepage/+/md-pages/docs/)
* [Source](https://gerrit.googlesource.com/gerrit/)
* [Reviews](https://gerrit-review.googlesource.com/#/q/status:open+project:gerrit)
