Differential D17419 Diff 41894 src/docs/user/userguide/audit.diviner

Changeset View

Standalone View

src/docs/user/userguide/audit.diviner

	Show First 20 Lines • Show All 53 Lines • ▼ Show 20 Lines
	Users interact with commits by leaving comments and applying actions, like			Users interact with commits by leaving comments and applying actions, like
	accepting the changes or raising a concern. These actions change the state of			accepting the changes or raising a concern. These actions change the state of
	their own audit and the overall audit state of the commit. Here's an example of			their own audit and the overall audit state of the commit. Here's an example of
	a typical audit workflow:			a typical audit workflow:

	- Alice publishes a commit containing some Javascript.			- Alice publishes a commit containing some Javascript.
	- This triggers an audit request to Bailey, the Javascript technical			- This triggers an audit request to Bailey, the Javascript technical
	lead on the project (see below for a description of trigger mechanisms).			lead on the project (see below for a description of trigger mechanisms).
	- Later, Bailey logs into Phabrictor and sees the audit request. She ignores			- Later, Bailey logs into Phabricator and sees the audit request. She ignores
	it for the moment, since it isn't blocking anything. At the end of the			it for the moment, since it isn't blocking anything. At the end of the
	week she looks through her open requests to see what the team has been			week she looks through her open requests to see what the team has been
	up to.			up to.
	- Bailey notices a few minor problems with Alice's commit. She leaves			- Bailey notices a few minor problems with Alice's commit. She leaves
	comments describing improvements and uses "Raise Concern" to send the			comments describing improvements and uses "Raise Concern" to send the
	commit back into Alice's queue.			commit back into Alice's queue.
	- Later, Alice logs into Phabricator and sees that Bailey has raised a			- Later, Alice logs into Phabricator and sees that Bailey has raised a
	concern (usually, Alice will also get an email). She resolves the issue			concern (usually, Alice will also get an email). She resolves the issue
	▲ Show 20 Lines • Show All 132 Lines • Show Last 20 Lines