@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Document project tone formally
Summary: Standards and practices.
Test Plan: Read carefully.
Reviewers: chad
Reviewed By: chad
Subscribers: epriestley
Differential Revision: https://secure.phabricator.com/D13641
+52
+52
src/docs/user/userguide/tone.diviner
+52
src/docs/user/userguide/tone.diviner
···
1
+
@title User Guide: Project Tone
2
+
@group userguide
3
+
4
+
Explains why Phabricator uses a lighthearted tone.
5
+
6
+
Overview
7
+
========
8
+
9
+
Phabricator uses a lighthearted tone in documentation and some interfaces, and
10
+
includes some features which primarily exist to add flavor or make things
11
+
sillier.
12
+
13
+
We use this tone because we like building software like this, and the feedback
14
+
we receive about it from users is overwhelmingly (and often effusively)
15
+
positive.
16
+
17
+
18
+
Removing Flavor
19
+
===============
20
+
21
+
Although almost all feedback about project tone that we receive is positive, a
22
+
few users don't like the tone very much (possibly including you if you've been
23
+
linked to this document). If you prefer a more straightforward tone, you can
24
+
disable most of the flavor by turning on the `phabricator.serious-business`
25
+
setting in the {nav Config} application.
26
+
27
+
(Not everything is covered by this setting. For example, it won't change the
28
+
documentation.)
29
+
30
+
If you don't like a piece of flavor because it creates legitimate difficulty or
31
+
confusion for you or your users and makes it harder to use Phabricator, let us
32
+
know. We don't intend flavor or tone to get in the way of usability, and can
33
+
sometimes take a joke too far (particularly for users who don't speak English
34
+
natively).
35
+
36
+
If you don't like a piece of flavor because it's a joke that you don't get or
37
+
don't find particularly funny, but it doesn't impact your ability to understand
38
+
or use the software, we're less likely to remove it. We find all our jokes very
39
+
very funny and cherish each of them dearly.
40
+
41
+
(If you're committed to removing flavor on grounds of taste, we //might// be
42
+
willing to accept changes which replace our objectively very very funny jokes
43
+
with even better ones.)
44
+
45
+
46
+
Next Steps
47
+
==========
48
+
49
+
Continue by:
50
+
51
+
- ignoring this document and complaining about a joke that you don't think is
52
+
very funny with @{article:Contributing Bug Reports}.