mirror of
https://github.com/WordPress/WordPress-Coding-Standards.git
synced 2025-08-30 03:11:24 +08:00
Update README and CONTRIBUTING regarding the new properties wiki page.
This commit is contained in:
parent
543bd68ede
commit
efbe25443e
2 changed files with 15 additions and 1 deletions
|
@ -12,6 +12,13 @@ Once a commit is made to `develop`, a PR should be opened from `develop` into `m
|
|||
|
||||
# Considerations when writing sniffs
|
||||
|
||||
## Public properties
|
||||
|
||||
When writing sniffs, always remember that any `public` sniff property can be overruled via a custom ruleset by the end-user.
|
||||
Only make a property `public` if that is the intended behaviour.
|
||||
|
||||
When you introduce new `public` sniff properties, or your sniff extends a class from which you inherit a `public` property, please don't forget to update the [public properties wiki page](https://github.com/WordPress-Coding-Standards/WordPress-Coding-Standards/wiki/Customizable-sniff-properties) with the relevant details once your PR has been merged into the `develop` branch.
|
||||
|
||||
## Whitelist comments
|
||||
|
||||
Sometimes, a sniff will flag code which upon further inspection by a human turns out to be OK.
|
||||
|
|
|
@ -12,6 +12,7 @@
|
|||
* [Rulesets](#rulesets)
|
||||
+ [Standards subsets](#standards-subsets)
|
||||
+ [Using a custom ruleset](#using-a-custom-ruleset)
|
||||
+ [Customizing sniff behaviour](#customizing-sniff-behaviour)
|
||||
+ [Recommended additional rulesets](#recommended-additional-rulesets)
|
||||
* [How to use](#how-to-use)
|
||||
+ [Command line](#command-line)
|
||||
|
@ -106,7 +107,13 @@ You can use the following as standard names when invoking `phpcs` to select snif
|
|||
|
||||
### Using a custom ruleset
|
||||
|
||||
If you need to further customize selection of sniffs for your project — you can create custom `ruleset.xml` standard. See provided [project.ruleset.xml.example](project.ruleset.xml.example) file and [fully annotated example](https://github.com/squizlabs/PHP_CodeSniffer/wiki/Annotated-ruleset.xml) in PHP_CodeSniffer documentation.
|
||||
If you need to further customize the selection of sniffs for your project — you can create a custom `phpcs.xml` standard. See provided [project.ruleset.xml.example](project.ruleset.xml.example) file and [fully annotated example](https://github.com/squizlabs/PHP_CodeSniffer/wiki/Annotated-ruleset.xml) in PHP_CodeSniffer documentation.
|
||||
|
||||
### Customizing sniff behaviour
|
||||
|
||||
The WordPress Coding Standard contains a number of sniffs which are configurable. This means that you can turn parts of the sniff on or off, or change the behaviour by setting a property for the sniff in your custom `ruleset.xml` file.
|
||||
|
||||
You can find a complete list of all the properties you can change in the [wiki](https://github.com/WordPress-Coding-Standards/WordPress-Coding-Standards/wiki/Customizable-sniff-properties).
|
||||
|
||||
### Recommended additional rulesets
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue