diff --git a/.arclint b/.arclint --- 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 --- a/src/docs/contributor/general_coding_standards.diviner +++ b/src/docs/contributor/general_coding_standards.diviner @@ -69,7 +69,8 @@ - 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 --- 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 --- a/src/docs/flavor/writing_reviewable_code.diviner +++ b/src/docs/flavor/writing_reviewable_code.diviner @@ -79,8 +79,8 @@ = 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 --- a/src/docs/user/userguide/arcanist_lint_unit.diviner +++ b/src/docs/user/userguide/arcanist_lint_unit.diviner @@ -37,8 +37,9 @@ = 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 --- a/src/docs/user/userguide/diviner.diviner +++ b/src/docs/user/userguide/diviner.diviner @@ -45,9 +45,9 @@ 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