Skip to content

Commit 3ac24ef

Browse files
committed
[SQUASH-ME] Title case for "Wiki"
1 parent 4321eb6 commit 3ac24ef

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

CONTRIBUTING.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Table of Contents
44

55
* [PHP_CodeSniffer Wiki](#php_codesniffer-wiki)
6-
* [How does the wiki get updated ?](#how-does-the-wiki-get-updated-)
6+
* [How does the Wiki get updated ?](#how-does-the-wiki-get-updated-)
77
* [Contributing to the Wiki](#contributing-to-the-wiki)
88
* [Guidelines for updating the wiki files](#guidelines-for-updating-the-wiki-files)
99
* [Running the pre-processing locally](#running-the-pre-processing-locally)
@@ -20,7 +20,7 @@ For now, the documentation for the PHP_CodeSniffer project is available via the
2020

2121
* The source of the Wiki was imported into this repository to maintain the commit history.
2222
* A [GitHub Actions workflow](https://github.com/PHPCSStandards/PHP_CodeSniffer-documentation/blob/main/.github/workflows/publish-wiki.yml) was added:
23-
* It pre-processes the `.md` files to replace placeholders and inject some other content (see [Guidelines for updating the wiki files](#guidelines-for-updating-the-wiki-files)).
23+
* It pre-processes the `.md` files to replace placeholders and inject some other content (see [Guidelines for Updating the Wiki Files](#guidelines-for-updating-the-wiki-files)).
2424
* And then it pushes the resulting updated `.md` files to the upstream Wiki repo.
2525

2626
<p align="right"><a href="#table-of-contents">back to top</a></p>
@@ -37,7 +37,7 @@ If you would like to improve the documentation:
3737
6. Submit a pull request from your fork to this repository. This process is documented in more detail in the [GitHub Docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork).
3838
7. Please ensure your pull requests passes all automated quality checks.
3939
8. If you updated anything which will be auto-replaced via the pre-processing:
40-
* The GitHub Actions workflow will do a "dry-run" for every PR (pre-process only, no push to the wiki).
40+
* The GitHub Actions workflow will do a "dry-run" for every PR (pre-process only, no push to the Wiki).
4141
* Please download the artifact which was created via this dry-run and verify the pre-processing replaced the output in the way you expected.
4242

4343
When in doubt, open an issue first to discuss your change proposal.
@@ -48,7 +48,7 @@ When in doubt, open an issue first to discuss your change proposal.
4848
### Guidelines for Updating the Wiki Files
4949

5050
* Small PRs fixing only one thing will be better received than larger PRs fixing a lot of things in one go.
51-
* Always use fully qualified links. This ensures that the links will work when pages are viewed/edited in this repo, as well as when the pages are viewed from the PHPCS wiki.
51+
* Always use fully qualified links. This ensures that the links will work when pages are viewed/edited in this repo, as well as when the pages are viewed from the PHPCS Wiki.
5252
* Add table of contents markers if appropriate.
5353
The start of a page containing a table of contents should look like this:
5454
```md
@@ -65,7 +65,7 @@ When in doubt, open an issue first to discuss your change proposal.
6565
* A marker MUST look like `{{COMMAND-OUTPUT ...}}` with `...` being replacement with a quoted `phpcs` or `phpcbf` command.
6666
* A marker MUST be at the start of a line.
6767
* A marker MUST be on a line by itself.
68-
* Commands will be run from the project root directory. Keep this in mind when adding a command replacement marker to a wiki file.
68+
* Commands will be run from the project root directory. Keep this in mind when adding a command replacement marker to a Wiki file.
6969
* The command replacement will not add markdown code fence syntax, so make sure to do this yourself.
7070
* If a code sample is needed to generate the desired output, place the code sample in a file in the `build/wiki-code-samples` directory.
7171

@@ -88,7 +88,7 @@ build/wiki-command-replacer.sh
8888

8989
Notes:
9090
* For the bash script to succeed, the `phpcs` and `phpcbf` commands need to be available in the `PATH` for your OS.
91-
* The bash script will copy the wiki files to the `_wiki` directory before making any replacements to prevent anyone accidentally committing the processed files.
91+
* The bash script will copy the Wiki files to the `_wiki` directory before making any replacements to prevent anyone accidentally committing the processed files.
9292

9393
The table of contents generation can be tested locally by installing the `doctoc` tool and running this locally like so:
9494

@@ -100,7 +100,7 @@ doctoc ./_wiki/Version-4.0-User-Upgrade-Guide.md --github --maxlevel 3 --update-
100100

101101
Note that this presumes the command replacer has already run and the files have already been copied to the `_wiki` directory.
102102

103-
If you only want to test the TOC generation, make sure you copy the wiki files to the `_wiki` directory before running these commands.
103+
If you only want to test the TOC generation, make sure you copy the Wiki files to the `_wiki` directory before running these commands.
104104

105105
<p align="right"><a href="#table-of-contents">back to top</a></p>
106106

@@ -140,7 +140,7 @@ To run the quality checks locally, install the following tooling:
140140

141141
Publicly editable Wiki pages for big projects get vandalized pretty often and we don't want to risk this type of vandalism leading to users getting incorrect information.
142142

143-
As a secondary reason, there are parts of the wiki (especially the output examples), which were pretty out of date.
144-
By having the wiki source in this repository, it allows for automating certain updates which would otherwise have to be done manually.
143+
As a secondary reason, there are parts of the Wiki (especially the output examples), which were pretty out of date.
144+
By having the Wiki source in this repository, it allows for automating certain updates which would otherwise have to be done manually.
145145

146146
<p align="right"><a href="#table-of-contents">back to top</a></p>

0 commit comments

Comments
 (0)