Differential D25007 Diff 23 src/docs/user/userguide/tone.diviner

Changeset View

Standalone View

src/docs/user/userguide/tone.diviner

	@title User Guide: Project Tone			@title User Guide: Project Tone
	@group userguide			@group userguide

	Explains why Phabricator uses a lighthearted tone.			Explains why Phorge uses a lighthearted tone.

	Overview			Overview
	========			========

	Phabricator uses a lighthearted tone in documentation and some interfaces, and			Phorge uses a lighthearted tone in documentation and some interfaces, and
	includes some features which primarily exist to add flavor or make things			includes some features which primarily exist to add flavor or make things
	sillier.			sillier.

	We use this tone because we like building software like this, and the feedback			We use this tone because we like building software like this, and the feedback
	we receive about it from users is overwhelmingly (and often effusively)			we receive about it from users is overwhelmingly (and often effusively)
	positive.			positive.


	Removing Flavor			Removing Flavor
	===============			===============

	Although almost all feedback about project tone that we receive is positive, a			Although almost all feedback about project tone that we receive is positive, a
	few users don't like the tone very much (possibly including you if you've been			few users don't like the tone very much (possibly including you if you've been
	linked to this document). If you prefer a more straightforward tone, you can			linked to this document). If you prefer a more straightforward tone, you can
	disable most of the flavor by turning on the `phabricator.serious-business`			disable most of the flavor by turning on the `phabricator.serious-business`
	setting in the {nav Config} application.			setting in the {nav Config} application.

	(Not everything is covered by this setting. For example, it won't change the			(Not everything is covered by this setting. For example, it won't change the
	documentation.)			documentation.)

	If you don't like a piece of flavor because it creates legitimate difficulty or			If you don't like a piece of flavor because it creates legitimate difficulty or
	confusion for you or your users and makes it harder to use Phabricator, let us			confusion for you or your users and makes it harder to use Phorge, let us
	know. We don't intend flavor or tone to get in the way of usability, and can			know. We don't intend flavor or tone to get in the way of usability, and can
	sometimes take a joke too far (particularly for users who don't speak English			sometimes take a joke too far (particularly for users who don't speak English
	natively).			natively).

	If you don't like a piece of flavor because it's a joke that you don't get or			If you don't like a piece of flavor because it's a joke that you don't get or
	don't find particularly funny, but it doesn't impact your ability to understand			don't find particularly funny, but it doesn't impact your ability to understand
	or use the software, we're less likely to remove it. We find all our jokes very			or use the software, we're less likely to remove it. We find all our jokes very
	very funny and cherish each of them dearly.			very funny and cherish each of them dearly.
	Show All 13 Lines