mirror of
https://we.phorge.it/source/phorge.git
synced 2024-12-11 16:16:14 +01:00
ef556090f8
Summary: Standards and practices. Test Plan: Read carefully. Reviewers: chad Reviewed By: chad Subscribers: epriestley Differential Revision: https://secure.phabricator.com/D13641
52 lines
1.8 KiB
Text
52 lines
1.8 KiB
Text
@title User Guide: Project Tone
|
|
@group userguide
|
|
|
|
Explains why Phabricator uses a lighthearted tone.
|
|
|
|
Overview
|
|
========
|
|
|
|
Phabricator uses a lighthearted tone in documentation and some interfaces, and
|
|
includes some features which primarily exist to add flavor or make things
|
|
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
|
|
===============
|
|
|
|
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
|
|
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.
|
|
|
|
(If you're committed to removing flavor on grounds of taste, we //might// be
|
|
willing to accept changes which replace our objectively very very funny jokes
|
|
with even better ones.)
|
|
|
|
|
|
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}.
|