Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add anchors for sections of contributing.md #179

Merged
merged 1 commit into from
Nov 25, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ or by fixing one by [submitting a pull request](#submit-a-pull-request).
As all the repositories are hosted on GitHub,
you will need a GitHub account to do either of these.

<a name="report-a-bug"></a>
## Report a Bug

If you have found a bug on any of the PHP documentation pages,
Expand All @@ -18,13 +19,15 @@ you can file a bug report by doing the following:
- add all necessary details to the description textarea
- click the "Submit new issue" button to file your bug report

<a name="submit-a-pull-request"></a>
## Submit a Pull Request

There are two ways to make changes to the documentation:
- make [minor changes](#minor-changes) by editing files on GitHub
- make [more complex changes](#more-complex-changes--building-the-php-documentation)
and validate/build the documentation locally on your computer

<a name="minor-changes"></a>
## Minor changes

To make trivial changes (typos, shorter wording changes or adding/removing short segments)
Expand All @@ -45,6 +48,7 @@ The repository will run a few basic checks on the changes
(e.g. whether the XML markup is valid, whether trailing whitespaces are stripped, etc.)
and your PR is ready to be discussed with and merged by the maintainers.

<a name="more-complex-changes--building-the-php-documentation"></a>
## More Complex Changes / Building the PHP documentation

To build and view the documentation after making more extensive changes
Expand All @@ -59,10 +63,12 @@ If you'd like to know more about what each repository is
and/or how PHP's documentation is built please refer to
the [overview](overview.md).

<a name="make-changes-to-the-documentation"></a>
### Make changes to the documentation

[Make your changes](editing.md) keeping in mind the [style guidelines](style.md).

<a name="commit-changes-and-open-a-pr"></a>
### Commit changes and open a PR

- commit your changes
Expand Down
Loading