Title: The new `docs\Rules\README.md` format causes merge issues · Issue #2220 · PowerShell/PSScriptAnalyzer · GitHub
Open Graph Title: The new `docs\Rules\README.md` format causes merge issues · Issue #2220 · PowerShell/PSScriptAnalyzer
X Title: The new `docs\Rules\README.md` format causes merge issues · Issue #2220 · PowerShell/PSScriptAnalyzer
Description: (this concerns contribution -documentation- issue) As far as I can tell, the new docs\Rules\README.md setup (PR2196) will cause a merge conflict with every new rule added to the analyzer repo like: #2186 and #2183. The new format change:...
Open Graph Description: (this concerns contribution -documentation- issue) As far as I can tell, the new docs\Rules\README.md setup (PR2196) will cause a merge conflict with every new rule added to the analyzer repo like:...
X Description: (this concerns contribution -documentation- issue) As far as I can tell, the new docs\Rules\README.md setup (PR2196) will cause a merge conflict with every new rule added to the analyzer repo like:...
Opengraph URL: https://github.com/PowerShell/PSScriptAnalyzer/issues/2220
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"The new `docs\\Rules\\README.md` format causes merge issues","articleBody":"(this concerns contribution -documentation- issue)\n\nAs far as I can tell, the new [`docs\\Rules\\README.md`](https://raw.githubusercontent.com/PowerShell/PSScriptAnalyzer/refs/heads/main/docs/Rules/README.md) setup ([PR2196](https://github.com/PowerShell/PSScriptAnalyzer/pull/2196)) will cause a merge conflict with every new rule added to the analyzer repo like: [#2186](https://github.com/PowerShell/PSScriptAnalyzer/pull/2186/conflicts) and [#2183](https://github.com/PowerShell/PSScriptAnalyzer/pull/2183/conflicts).\n\nThe new format change:\n* Update rules index (docs/Rules/README.md) to a new “Default state” model and add link references for maintainability\nWhich results in a table like:\n\n```\n| Rule | Severity | Default state | Configurable |\n| -------------------------------------------------- | ----------- | :------------: | :----------: |\n| [AlignAssignmentStatement][02] | Warning | Disabled | Yes |\n| [AvoidAssignmentToAutomaticVariable][03] | Warning | Always enabled | |\n| [AvoidDefaultValueForMandatoryParameter][04] | Warning | Always enabled | |\n...\n```\n\nAnd a reference list like:\n```\n\u003c!-- link references -->\n[01]: ../using-scriptanalyzer.md#suppressing-rules\n[02]: AlignAssignmentStatement.md\n[03]: AvoidAssignmentToAutomaticVariable.md\n[04]: AvoidDefaultValueForMandatoryParameter.md\n[05]: AvoidDefaultValueSwitchParameter.md\n...\n```\n\nMight be a beter practice for a static `README.md`, it isn't for a dynamic `README.md` that needs to be updated with each new rule. The difficulty is because the rule list is alphabetically and inserting a new rule document to the list requires to update **all following** rules and reference links (that are not related to the new rule PR). Doing so, is in fact rather difficult to maintain and error prone.\n\nA workaround might simply using the next available reference number (e.g. `[81]`) but that would then appear somewhere in the middle of the list (depending on the rule _name_) with is quite inconsistent and doesn't add much value to the \"maintainability\".","author":{"url":"https://github.com/iRon7","@type":"Person","name":"iRon7"},"datePublished":"2026-09-29T11:07:37Z","url":"https://github.com/PowerShell/PSScriptAnalyzer/issues/2220"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:c52ad717-d613-0ebb-9c45-5c7cf1db8fb8 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | BC60:2A4E9B:28DD5E:3625A9:6AFCE22C |
| html-safe-nonce | 12dae5278e8d1e164a4e924068589e94bf2a9e2972a20fd4925dbcc9875a3aed |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCQzYwOjJBNEU5QjoyOERENUU6MzYyNUE5OjZBRkNFMjJDIiwidmlzaXRvcl9pZCI6IjI2MDY4MTYxMTYwMTU2ODMwMCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | daa42ac147bfe8592c3bfdea6049bde69e646214c5005fac16ca9e217586d350 |
| hovercard-subject-tag | issue:5629526912 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/PowerShell/PSScriptAnalyzer/2220/issue_layout |
| twitter:image | https://opengraph.githubassets.com/4c3d30b42bf43995c91a39980483a03ef433ed726fe3a9eadf21614526aea13a/PowerShell/PSScriptAnalyzer/issues/2220 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/4c3d30b42bf43995c91a39980483a03ef433ed726fe3a9eadf21614526aea13a/PowerShell/PSScriptAnalyzer/issues/2220 |
| og:image:alt | (this concerns contribution -documentation- issue) As far as I can tell, the new docs\Rules\README.md setup (PR2196) will cause a merge conflict with every new rule added to the analyzer repo like:... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | iRon7 |
| hostname | github.com |
| expected-hostname | github.com |
| None | 0c05b7eb5b95e29725d01bb1f560a020e3fafd0f033c6b9ed3918fa3161254dd |
| turbo-cache-control | no-preview |
| go-import | github.com/PowerShell/PSScriptAnalyzer git https://github.com/PowerShell/PSScriptAnalyzer.git |
| octolytics-dimension-user_id | 11524380 |
| octolytics-dimension-user_login | PowerShell |
| octolytics-dimension-repository_id | 33149177 |
| octolytics-dimension-repository_nwo | PowerShell/PSScriptAnalyzer |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 33149177 |
| octolytics-dimension-repository_network_root_nwo | PowerShell/PSScriptAnalyzer |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 79d9154e55368884c8c93766ba4fee076343d37f |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width