Differential D13641 Diff 32967 src/docs/user/userguide/tone.diviner

Changeset View

Standalone View

src/docs/user/userguide/tone.diviner

This file was added.

				@title User Guide: Project Tone
				@group userguide

				Explains why Phabricator uses a lighthearted tone.

				Overview
				xgouchetUnsubmitted Not Done Inline Actions Hello World Seems like a nice title xgouchet: Hello World Seems like a nice title
				========

				Phabricator uses a lighthearted tone in documentation and some interfaces, and
				includes some features which primarily exist to add flavor or make things
				pha_testUnsubmitted Not Done Inline Actions error ? pha_test: error ?
				sillier.

				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)
				positive.


				Removing Flavor
				===============
				bdraegerUnsubmitted Not Done Inline Actions This is not good! bdraeger: This is not good!

				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
				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`
				setting in the {nav Config} application.

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

				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
				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
				aaUnsubmitted Not Done Inline Actions test aa: test
				natively).

				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
				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.
				apexljUnsubmitted Not Done Inline Actions Hava a try! apexlj: Hava a try!
				tuscanUnsubmitted Not Done Inline Actions k tuscan: k
				aaUnsubmitted Not Done Inline Actions sadasdf aa: sadasdf

				(If you're committed to removing flavor on grounds of taste, we //might// be
				bdraegerUnsubmitted Not Done Inline Actions You should change this! bdraeger: You should change this!
				willing to accept changes which replace our objectively very very funny jokes
				with even better ones.)
				toddtUnsubmitted Not Done Inline Actions Test comment. toddt: Test comment.
				toddtUnsubmitted Not Done Inline Actions Test reply. toddt: Test reply.


				Next Steps
				==========

				Continue by:

				- ignoring this document and complaining about a joke that you don't think is
				very funny with @{article:Contributing Bug Reports}.