diff --git a/.arclint b/.arclint index c7a8fc9501..cc4f7b11e0 100644 --- a/.arclint +++ b/.arclint @@ -32,6 +32,7 @@ "json": { "type": "json", "include": [ + "(^src/docs/book/.*\\.book$)", "(^support/jshint/jshintconfig$)", "(^\\.arcconfig$)", "(^\\.arclint$)", diff --git a/src/docs/contributor/general_coding_standards.diviner b/src/docs/contributor/general_coding_standards.diviner index a2294d0e10..45081231bb 100644 --- a/src/docs/contributor/general_coding_standards.diviner +++ b/src/docs/contributor/general_coding_standards.diviner @@ -69,7 +69,8 @@ gather concrete performance data. - Follow language-specific conventions. - Name things unambiguously. - Choose descriptive names. - - Avoid nonstandard abbreviations (common abbreviations like ID, URI and HTTP are fine). + - Avoid nonstandard abbreviations (common abbreviations like ID, URI and HTTP + are fine). - Spell words correctly. - Use correct grammar. diff --git a/src/docs/contributor/php_coding_standards.diviner b/src/docs/contributor/php_coding_standards.diviner index 78021a2f9f..93957845ce 100644 --- a/src/docs/contributor/php_coding_standards.diviner +++ b/src/docs/contributor/php_coding_standards.diviner @@ -1,7 +1,8 @@ @title PHP Coding Standards @group standards -This document describes PHP coding standards for Phabricator and related projects (like Arcanist and libphutil). +This document describes PHP coding standards for Phabricator and related +projects (like Arcanist and libphutil). = Overview = diff --git a/src/docs/flavor/writing_reviewable_code.diviner b/src/docs/flavor/writing_reviewable_code.diviner index 7e840b7b6d..955fe65905 100644 --- a/src/docs/flavor/writing_reviewable_code.diviner +++ b/src/docs/flavor/writing_reviewable_code.diviner @@ -79,8 +79,8 @@ reviewing big checkins. = Write Sensible Commit Messages = -There are lots of resources for this on the internet. All of them say pretty much -the same thing; this one does too. +There are lots of resources for this on the internet. All of them say pretty +much the same thing; this one does too. The single most important thing is: **commit messages should explain //why// you are making the change**. diff --git a/src/docs/user/userguide/arcanist_lint_unit.diviner b/src/docs/user/userguide/arcanist_lint_unit.diviner index 1596a0bbee..d9cc107440 100644 --- a/src/docs/user/userguide/arcanist_lint_unit.diviner +++ b/src/docs/user/userguide/arcanist_lint_unit.diviner @@ -37,8 +37,9 @@ make this work, you need to do three things: = Create a libphutil Library = If you haven't created a library for the class to live in yet, you need to do -that first. Follow the instructions in @{article:libphutil Libraries User Guide}, -then make the library loadable by adding it to your ##.arcconfig## like this: +that first. Follow the instructions in +@{article:libphutil Libraries User Guide}, then make the library loadable by +adding it to your ##.arcconfig## like this: { // ... diff --git a/src/docs/user/userguide/diviner.diviner b/src/docs/user/userguide/diviner.diviner index e392a606d5..e94c33d275 100644 --- a/src/docs/user/userguide/diviner.diviner +++ b/src/docs/user/userguide/diviner.diviner @@ -45,9 +45,9 @@ look like this: The properties in this file are: - - `name`: Required. Short, unique name to identify the documentation book. This - will be used in URIs, so it should not have special characters. Good names - are things like `"example"` or `"libcabin"`. + - `name`: Required. Short, unique name to identify the documentation book. + This will be used in URIs, so it should not have special characters. Good + names are things like `"example"` or `"libcabin"`. - `root`: Required. The root directory (relative to the `.book` file) which documentation should be generated from. Often this will be a value like `"../../"`, to specify the project root (for example, if the `.book` file