Custom localfile

.gitattributes

@@ -1,14 +1,27 @@
-.cspell.json export-ignore
-.gitattributes export-ignore
-.github/ export-ignore
-.gitignore export-ignore
-package.xml export-ignore
-phpcs.xml.dist export-ignore
-phpstan.neon export-ignore
-phpunit.xml.dist export-ignore
-scripts/ export-ignore
+#
+# Exclude these files from release archives.
+# This will also make them unavailable when using Composer with `--prefer-dist`.
+# If you develop for this repo using Composer, use `--prefer-source`.
+# https://www.reddit.com/r/PHP/comments/2jzp6k/i_dont_need_your_tests_in_my_production/
+# https://blog.madewithlove.be/post/gitattributes/
+#
+.github/                export-ignore
+scripts/                export-ignore
+.cspell.json            export-ignore
+.gitattributes          export-ignore
+.gitignore              export-ignore
+.markdownlint-cli2.yaml export-ignore
+.remarkignore           export-ignore
+.remarkrc               export-ignore
+.yamllint.yml           export-ignore
+phpcs.xml.dist          export-ignore
+phpstan.neon.dist       export-ignore
+phpunit.xml.dist        export-ignore
 
+#
 # Declare files that should always have CRLF line endings on checkout.
+#
 *WinTest.inc text eol=crlf
 *WinTest.php text eol=crlf
 src/Standards/Generic/Tests/Files/LineEndingsUnitTest*.inc text eol=crlf
+tests/Core/Fixer/Fixtures/GenerateDiffTest-WindowsLineEndings.inc text eol=crlf

.github/ISSUE_TEMPLATE/bug_report.md

@@ -19,18 +19,20 @@ standard repository (not here).
 -->
 
 ## Describe the bug
+
 A clear and concise description of what the bug is.
 
 ### Code sample
 ```php
-echo "A short code snippet that can be used to reproduce the bug. Do NOT paste screenshots of code!";
+echo 'A short code snippet that can be used to reproduce the bug.';
+echo 'Do NOT paste screenshots of code!";
 ```
 
 ### Custom ruleset
 ```xml
 <?xml version="1.0"?>
 <ruleset name="My Custom Standard">
-  <description>If you are using a custom ruleset, please enter it here.</description>
+  <description>If you are using a custom ruleset, please enter the relevant part here.</description>
 </ruleset>
 ```
 
@@ -39,28 +41,31 @@ Steps to reproduce the behavior:
 1. Create a file called `test.php` with the code sample above...
 2. Run `phpcs test.php ...`
 3. See error message displayed
-```
+```text
 PHPCS output here
 ```
 
 ## Expected behavior
+
 A clear and concise description of what you expected to happen.
 
 ## Versions (please complete the following information)
 
-| | |
-|-|-|
-| Operating System | [e.g., Windows 10, MacOS 10.15]
-| PHP version | [e.g., 7.2, 7.4]
-| PHP_CodeSniffer version | [e.g., 3.5.5, master]
-| Standard | [e.g., PSR2, PSR12, Squiz, custom]
-| Install type | [e.g. Composer (global/local), PHAR, PEAR, git clone, other (please expand)]
+|                                       |                                                                                                           |
+|--------------------------|----------------------------------------------------------------------  |
+| Operating System           | [e.g., Windows 10, MacOS 10.15]                                                       |
+| PHP version                    | [e.g., 7.2, 8.1]                                                                                     |
+| PHP_CodeSniffer version | [e.g., 3.7.2, master]                                                                            |
+| Standard                         | [e.g., PSR2, PSR12, Squiz, custom]                                                      |
+| Install type                      | [e.g. Composer (global/local), PHAR, git clone, other (please expand)] |
 
 ## Additional context
+
 Add any other context about the problem here.
 
-## Please confirm:
+## Please confirm
 
 - [ ] I have searched the issue list and am not opening a duplicate issue.
+- [ ] I have read the [Contribution Guidelines](https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/.github/CONTRIBUTING.md) and this is not a [support question](https://github.com/PHPCSStandards/PHP_CodeSniffer/discussions).
 - [ ] I confirm that this bug is a bug in PHP_CodeSniffer and not in one of the external standards.
 - [ ] I have verified the issue still exists in the `master` branch of PHP_CodeSniffer.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Community Support
+    url: https://github.com/PHPCSStandards/PHP_CodeSniffer/discussions?discussions_q=-category%3AAnnouncements
+    about: Support questions belong in Discussions, not in the issue tracker.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature request
+about: I have a suggestion (and may want to implement it).
+title: ''
+labels: ['Status: triage', 'Type: enhancement']
+assignees: ''
+
+---
+
+## Is your feature request related to a problem?
+<!-- Please provide a clear and concise description of what the feature is which you'd like to see implemented. -->
+
+## Describe the solution you'd like
+<!--
+A clear and concise description of what you want to happen.
+
+Please include some code samples of what should be flagged and preferably also some
+code samples of what should *not* be flagged.
+-->
+
+## Additional context (optional)
+<!-- Add any other context or screenshots about the feature request here. -->
+
+- [ ] I have read the [Contribution Guidelines](https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/.github/CONTRIBUTING.md) and this is not a [support question](https://github.com/PHPCSStandards/PHP_CodeSniffer/discussions).
+- [ ] I intend to create a pull request to implement this feature.

.github/community-cc-list.md

@@ -0,0 +1,16 @@
+# PHP_CodeSniffer Community CC List
+
+<!--
+This list will be used on select tickets to ping the wider PHP_CodeSniffer community for input.
+
+If you want to be on this list, feel free to submit a PR to add yourself.
+If you want to be removed from the list, dito, submit a PR to remove yourself and it will be merged without questions.
+
+PRs adding/removing other people to/from the list will only be merged if the people being added/removed leave a comment on the PR consenting to it.
+
+When updating the list, please list GitHub handles in alphabetical order.
+
+For more context, see https://github.com/PHPCSStandards/PHP_CodeSniffer/issues/227
+-->
+
+/cc @asispts @dingo-d @fredden @GaryJones @greg0ire @kukulich @michalbundyra @Ocramius @sirbrillig @stronk7 @weierophinney @wimg

.github/dependabot.yml

@@ -0,0 +1,16 @@
+# Dependabot configuration.
+#
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "GH Actions:"
+    labels:
+      - "Type: chores/QA"

.github/labeler.yml

@@ -0,0 +1,101 @@
+version: 1
+appendOnly: true
+labels:
+  - label: "Status: triage"
+    draft: false
+    author-can-merge: false
+
+  - label: "Core Component: Config & Ruleset & CLI options"
+    draft: false
+    files:
+      - "src/Config.php$"
+  - label: "Core Component: Config & Ruleset & CLI options"
+    draft: false
+    files:
+      - "src/Ruleset.php$"
+  - label: "Core Component: File"
+    draft: false
+    files:
+      - "src/Files/.*"
+  - label: "Core Component: Fixer"
+    draft: false
+    files:
+      - "src/Fixer.php$"
+  - label: "Core Component: Generators"
+    draft: false
+    files:
+      - "src/Generators/.*"
+  - label: "Core Component: Reports"
+    draft: false
+    files:
+      - "src/Reports/.*"
+  - label: "Core Component: Tokenizer"
+    draft: false
+    files:
+      - "src/Tokenizers/.*"
+  - label: "Core Component: Utils"
+    draft: false
+    files:
+      - "src/Util/.*"
+
+  - label: "Focus: Comments/Docblocks"
+    draft: false
+    files:
+      - "src/Standards/.*/Sniffs/Commenting/"
+  - label: "Focus: Fixer Conflicts"
+    draft: false
+    body: ".* fixer conflict.*"
+
+  - label: "Standard: Generic"
+    draft: false
+    files:
+      - "src/Standards/Generic/(Docs|Sniffs)/.*"
+  - label: "Standard: MySource"
+    draft: false
+    files:
+      - "src/Standards/MySource/(Docs|Sniffs)/.*"
+  - label: "Standard: PEAR"
+    draft: false
+    files:
+      - "src/Standards/PEAR/(Docs|Sniffs)/.*"
+  - label: "Standard: PSR1"
+    draft: false
+    files:
+      - "src/Standards/PSR1/(Docs|Sniffs)/.*"
+  - label: "Standard: PSR2"
+    draft: false
+    files:
+      - "src/Standards/PSR2/(Docs|Sniffs)/.*"
+  - label: "Standard: PSR12"
+    draft: false
+    files:
+      - "src/Standards/PSR12/(Docs|Sniffs)/.*"
+  - label: "Standard: Squiz"
+    draft: false
+    files:
+      - "src/Standards/Squiz/(Docs|Sniffs)/.*"
+  - label: "Standard: Zend"
+    draft: false
+    files:
+      - "src/Standards/Zend/(Docs|Sniffs)/.*"
+
+  - label: "Type: breaking change"
+    draft: false
+    body: '[Xx]\] Breaking change'
+  - label: "Type: bug"
+    draft: false
+    body: '[Xx]\] Bug fix'
+  - label: "Type: enhancement"
+    draft: false
+    body: '[Xx]\] New feature'
+  - label: "Type: documentation"
+    draft: false
+    body: '[Xx]\] Documentation improvement'
+  - label: "Type: documentation"
+    draft: false
+    files:
+      - 'src/Standards/.*/Docs/[A-Za-z0-9-]*/.*Standard.xml$'
+  - label: "Type: documentation"
+    draft: false
+    files:
+      - "*.md$"

.github/pull_request_template.md

@@ -4,18 +4,21 @@
 Please target the `master` branch when submitting your pull request, unless your change **only** applies to PHPCS 4.x.
 -->
 
-## Description
+# Description
 <!--
 What do you want to achieve with this PR? Why did you write this code? What problem does this PR solve?
 Describe your changes in detail and, if relevant, explain which choices you have made and why.
 -->
 
 
-### Suggested changelog entry
-<!-- Please provide a short description of the change for the changelog. -->
+## Suggested changelog entry
+<!--
+Please provide a short description of the change for the changelog.
+This is only needed when this is an end-user, integrators or external standard maintainers facing change.
+-->
 
 
-### Related issues/external references
+## Related issues/external references
 
 Fixes #
 
@@ -32,20 +35,19 @@ Fixes #
 ## PR checklist
 <!-- Go over all the following points, and put an `x` in all the boxes that apply. -->
 - [ ] I have checked there is no other PR open for the same change.
-- [ ] I have read the [Contribution Guidelines](.github/CONTRIBUTING.md).
+- [ ] I have read the [Contribution Guidelines](https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/.github/CONTRIBUTING.md).
 - [ ] I grant the project the right to include and distribute the code under the BSD-3-Clause license (and I have the right to grant these rights).
 - [ ] I have added tests to cover my changes.
 - [ ] I have verified that the code complies with the projects coding standards.
-- [ ] [Required for new sniffs] I have added XML documentation for the sniff.
-- [ ] [Required for new files] I have added any new files to the `package.xml` file.
+- [ ] \[Required for new sniffs\] I have added XML documentation for the sniff.
 
 <!--
 ============================================================================================
 Please make sure your pull request passes all continuous integration checks!
 
 PRs which are failing their CI checks will likely be ignored by the maintainers.
 
-PRs using atomic, descriptive commits are hugely appreciated as it will make
+Small PRs using atomic, descriptive commits are hugely appreciated as it will make
 reviewing your changes easier for the maintainers.
 ============================================================================================
 -->