Page Menu
Home
Phabricator
Search
Configure Global Search
Log In
Files
F13958706
D8414.id19984.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Award Token
Flag For Later
Size
9 KB
Referenced Files
None
Subscribers
None
D8414.id19984.diff
View Options
Index: src/docs/book/contributor.book
===================================================================
--- /dev/null
+++ src/docs/book/contributor.book
@@ -0,0 +1,33 @@
+{
+ "name" : "phabcontrib",
+ "title" : "Phabricator Contributor Documentation",
+ "short" : "Phabricator Contributor Docs",
+ "preface" : "Information for Phabricator contributors.",
+ "root" : "../../../",
+ "uri.source" :
+ "https://secure.phabricator.com/diffusion/P/browse/master/%f$%l",
+ "rules" : {
+ "(\\.diviner$)" : "DivinerArticleAtomizer"
+ },
+ "exclude" : [
+ "(^externals/)",
+ "(^webroot/rsrc/externals/)",
+ "(^scripts/)",
+ "(^support/)",
+ "(^resources/)",
+ "(^src/docs/user/)",
+ "(^src/docs/tech/)",
+ "(^src/docs/flavor/)"
+ ],
+ "groups" : {
+ "contrib" : {
+ "name" : "Contributor Overview"
+ },
+ "standards" : {
+ "name" : "Coding Standards"
+ },
+ "developer" : {
+ "name" : "Developer Guides"
+ }
+ }
+}
Index: src/docs/book/flavor.book
===================================================================
--- /dev/null
+++ src/docs/book/flavor.book
@@ -0,0 +1,42 @@
+{
+ "name" : "phabflavor",
+ "title" : "Phabricator Flavor Text",
+ "short" : "Flavor Text",
+ "preface" : "Recommendations, lore, and dark rituals.",
+ "root" : "../../../",
+ "uri.source" :
+ "https://secure.phabricator.com/diffusion/P/browse/master/%f$%l",
+ "rules" : {
+ "(\\.diviner$)" : "DivinerArticleAtomizer"
+ },
+ "exclude" : [
+ "(^externals/)",
+ "(^webroot/rsrc/externals/)",
+ "(^scripts/)",
+ "(^support/)",
+ "(^resources/)",
+ "(^src/docs/user/)",
+ "(^src/docs/tech/)",
+ "(^src/docs/contributor/)"
+ ],
+ "groups" : {
+ "overview" : {
+ "name" : "Overview"
+ },
+ "review" : {
+ "name" : "Revision Control and Code Review"
+ },
+ "sundry" : {
+ "name" : "Sundries"
+ },
+ "lore" : {
+ "name" : "Phabricator Lore"
+ },
+ "php" : {
+ "name" : "PHP"
+ },
+ "javascript" : {
+ "name" : "Javascript"
+ }
+ }
+}
Index: src/docs/book/phabricator.book
===================================================================
--- src/docs/book/phabricator.book
+++ src/docs/book/phabricator.book
@@ -16,7 +16,9 @@
"(^scripts/)",
"(^support/)",
"(^resources/)",
- "(^src/docs/user/)"
+ "(^src/docs/user/)",
+ "(^src/docs/flavor/)",
+ "(^src/docs/contributor/)"
],
"groups" : {
"arcanist" : {
Index: src/docs/book/user.book
===================================================================
--- src/docs/book/user.book
+++ src/docs/book/user.book
@@ -15,7 +15,9 @@
"(^scripts/)",
"(^support/)",
"(^resources/)",
- "(^src/docs/tech/)"
+ "(^src/docs/tech/)",
+ "(^src/docs/flavor/)",
+ "(^src/docs/contributor/)"
],
"groups" : {
"intro" : {
Index: src/docs/contributor/general_coding_standards.diviner
===================================================================
--- src/docs/contributor/general_coding_standards.diviner
+++ src/docs/contributor/general_coding_standards.diviner
@@ -1,5 +1,5 @@
@title General Coding Standards
-@group contrib
+@group standards
This document is a general coding standard for contributing to Phabricator,
Arcanist, libphutil and Diviner.
Index: src/docs/contributor/internationalization.diviner
===================================================================
--- src/docs/contributor/internationalization.diviner
+++ src/docs/contributor/internationalization.diviner
@@ -1,5 +1,5 @@
@title Internationalization
-@group contrib
+@group developer
What is required from developers to get Phabricator translatable.
Index: src/docs/contributor/javascript_coding_standards.diviner
===================================================================
--- src/docs/contributor/javascript_coding_standards.diviner
+++ src/docs/contributor/javascript_coding_standards.diviner
@@ -1,5 +1,5 @@
@title Javascript Coding Standards
-@group contrib
+@group standards
This document describes Javascript coding standards for Phabricator and Javelin.
Index: src/docs/contributor/php_coding_standards.diviner
===================================================================
--- src/docs/contributor/php_coding_standards.diviner
+++ src/docs/contributor/php_coding_standards.diviner
@@ -1,5 +1,5 @@
@title PHP Coding Standards
-@group contrib
+@group standards
This document describes PHP coding standards for Phabricator and related projects (like Arcanist and libphutil).
Index: src/docs/flavor/about_flavor_text.diviner
===================================================================
--- src/docs/flavor/about_flavor_text.diviner
+++ src/docs/flavor/about_flavor_text.diviner
@@ -1,5 +1,5 @@
@title About Flavor Text
-@group flavortext
+@group overview
Explains what's going on here.
Index: src/docs/flavor/javascript_object_array.diviner
===================================================================
--- src/docs/flavor/javascript_object_array.diviner
+++ src/docs/flavor/javascript_object_array.diviner
@@ -1,5 +1,5 @@
@title Javascript Object and Array
-@group flavortext
+@group javascript
This document describes the behaviors of Object and Array in Javascript, and
a specific approach to their use which produces basically reasonable language
Index: src/docs/flavor/javascript_pitfalls.diviner
===================================================================
--- src/docs/flavor/javascript_pitfalls.diviner
+++ src/docs/flavor/javascript_pitfalls.diviner
@@ -1,5 +1,5 @@
@title Javascript Pitfalls
-@group flavortext
+@group javascript
This document discusses pitfalls and flaws in the Javascript language, and how
to avoid, work around, or at least understand them.
Index: src/docs/flavor/php_pitfalls.diviner
===================================================================
--- src/docs/flavor/php_pitfalls.diviner
+++ src/docs/flavor/php_pitfalls.diviner
@@ -1,5 +1,5 @@
@title PHP Pitfalls
-@group flavortext
+@group php
This document discusses difficult traps and pitfalls in PHP, and how to avoid,
work around, or at least understand them.
Index: src/docs/flavor/please_please_please.diviner
===================================================================
--- src/docs/flavor/please_please_please.diviner
+++ src/docs/flavor/please_please_please.diviner
@@ -1,5 +1,5 @@
@title Please Please Please
-@group flavortext
+@group sundry
Please read this document.
Index: src/docs/flavor/project_history.diviner
===================================================================
--- src/docs/flavor/project_history.diviner
+++ src/docs/flavor/project_history.diviner
@@ -1,5 +1,5 @@
@title Phabricator Project History
-@group flavortext
+@group lore
A riveting tale of adventure. In this document, I refer to worldly and
sophisticated engineer Evan Priestley as "I", which is only natural as I am he.
Index: src/docs/flavor/recommendations_on_branching.diviner
===================================================================
--- src/docs/flavor/recommendations_on_branching.diviner
+++ src/docs/flavor/recommendations_on_branching.diviner
@@ -1,5 +1,5 @@
@title Recommendations on Branching
-@group flavortext
+@group review
Project recommendations on how to organize branches.
Index: src/docs/flavor/recommendations_on_revision_control.diviner
===================================================================
--- src/docs/flavor/recommendations_on_revision_control.diviner
+++ src/docs/flavor/recommendations_on_revision_control.diviner
@@ -1,5 +1,5 @@
@title Recommendations on Revision Control
-@group flavortext
+@group review
Project recommendations on how to organize revision control.
Index: src/docs/flavor/soon_static_resources.diviner
===================================================================
--- src/docs/flavor/soon_static_resources.diviner
+++ src/docs/flavor/soon_static_resources.diviner
@@ -1,5 +1,5 @@
@title Things You Should Do Soon: Static Resources
-@group flavortext
+@group sundry
Over time, you'll write more JS and CSS and eventually need to put systems in
place to manage it.
Index: src/docs/flavor/things_you_should_do_now.diviner
===================================================================
--- src/docs/flavor/things_you_should_do_now.diviner
+++ src/docs/flavor/things_you_should_do_now.diviner
@@ -1,5 +1,5 @@
@title Things You Should Do Now
-@group flavortext
+@group sundry
Describes things you should do now when building software, because the cost to
do them increases over time and eventually becomes prohibitive or impossible.
Index: src/docs/flavor/things_you_should_do_soon.diviner
===================================================================
--- src/docs/flavor/things_you_should_do_soon.diviner
+++ src/docs/flavor/things_you_should_do_soon.diviner
@@ -1,5 +1,5 @@
@title Things You Should Do Soon
-@group flavortext
+@group sundry
Describes things you should start thinking about soon, because scaling will
be easier if you put a plan in place.
Index: src/docs/flavor/writing_reviewable_code.diviner
===================================================================
--- src/docs/flavor/writing_reviewable_code.diviner
+++ src/docs/flavor/writing_reviewable_code.diviner
@@ -1,5 +1,5 @@
@title Writing Reviewable Code
-@group flavortext
+@group review
Project recommendations on how to structure changes.
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Oct 15 2024, 4:11 PM (5 w, 8 h ago)
Storage Engine
blob
Storage Format
Encrypted (AES-256-CBC)
Storage Handle
6713429
Default Alt Text
D8414.id19984.diff (9 KB)
Attached To
Mode
D8414: Divide Phabricator documentation into four books
Attached
Detach File
Event Timeline
Log In to Comment