fix: resolve all markdownlint errors

- Replace 68 "[here]" links with descriptive text (MD059)
- Fix table separator spacing in 6 project files (MD060)
- Add trailing newlines to 2 files (MD047)
- Disable MD060 rule for .claude/ internal files
- Update markdownlint config with MD060: false

All project files now pass markdownlint --config .github/.markdownlint.yaml

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-23 01:47:47 +03:00
parent e808130d44
commit 59ac32e3b2
37 changed files with 68 additions and 68 deletions
+2 -2
View File
@@ -15,7 +15,7 @@
## Özet
| Kategori | Toplam | Tamamlanan | Durum |
|----------|--------|------------|-------|
| --- | --- | --- | --- |
| pez-* prefix | 29 | 29 | ✅ |
| pezbridge-* | 8 | 8 | ✅ |
| pezsnowbridge-* | 25 | 24 | ⚠️ 1 eksik |
@@ -31,7 +31,7 @@
## İlerleme Tablosu
| # | Yeni İsim | Durum | Konum |
|---|-----------|-------|-------|
| --- | --- | --- | --- |
| 1 | asset-test-pezutils | ✅ | pezcumulus/teyrchains/runtimes/assets/test-utils |
| 2 | pez-chain-spec-guide-runtime | ✅ | docs/sdk/src/reference_docs/chain_spec_runtime |
| 3 | pez-equivocation-detector | ✅ | pezbridges/relays/equivocation |
+2 -2
View File
@@ -64,7 +64,7 @@ merged faster.
### Labels
The set of labels and their description can be found [here](https://docs.pezkuwichain.io/labels/doc_polkadot-sdk.html).
The set of labels and their description can be found in the [label documentation](https://docs.pezkuwichain.io/labels/doc_polkadot-sdk.html).
### Process
@@ -111,7 +111,7 @@ Template](./PULL_REQUEST_TEMPLATE.md). Moreover, all pull requests must have a p
Pull Requests labelled with `R0-no-crate-publish-required` are exempt from prdoc documentation requirements.
See more about `prdoc` [here](./prdoc.md)
See more about `prdoc` in the [prdoc documentation](./prdoc.md)
## Crate Configuration `Cargo.toml`
+1 -1
View File
@@ -43,7 +43,7 @@ We also need [https://docs.pezkuwichain.io/](https://docs.pezkuwichain.io/) to b
## Announce the deprecation and removal
**At minimum they should be noted in the release log.** Please see how to document a PR [here](https://github.com/pezkuwichain/pezkuwi-sdk/blob/master/docs/contributor/CONTRIBUTING.md#documentation).
**At minimum they should be noted in the release log.** Please see how to document a PR [the contribution guidelines](https://github.com/pezkuwichain/pezkuwi-sdk/blob/master/docs/contributor/CONTRIBUTING.md#documentation).
There you can give instructions based on the audience and tell them what they need to do to upgrade the code.
Some breaking changes have a bigger impact than others. When the impact is big the release note is not enough, though
+6 -6
View File
@@ -75,8 +75,8 @@ There are good sources to look into:
Crate](https://blog.guillaume-gomez.fr/articles/2020-03-12+Guide+on+how+to+write+documentation+for+a+Rust+crate)
As mentioned
[here](https://web.mit.edu/rust-lang_v1.25/arch/amd64_ubuntu1404/share/doc/rust/html/book/first-edition/documentation.html#writing-documentation-comments)
and [here](https://blog.guillaume-gomez.fr/articles/2020-03-12+Guide+on+how+to+write+documentation+for+a+Rust+crate),
[the Rust documentation guide](https://web.mit.edu/rust-lang_v1.25/arch/amd64_ubuntu1404/share/doc/rust/html/book/first-edition/documentation.html#writing-documentation-comments)
and [the documentation blog post](https://blog.guillaume-gomez.fr/articles/2020-03-12+Guide+on+how+to+write+documentation+for+a+Rust+crate),
always start with a **single sentence** demonstrating what is documented. All additional documentation should be added
*after a newline*. Strive to make the first sentence succinct and short.The reason for this is the first paragraph of
docs about an item (everything before the first newline) is used as the excerpt that rust doc displays about this item
@@ -98,8 +98,8 @@ returned, and if the `Error` variants are overly complicated.
Strive to include correct links to other items in your written docs as much as possible.
Read more about how to correctly use links in your rust-docs
[here](https://doc.rust-lang.org/rustdoc/write-documentation/linking-to-items-by-name.html#valid-links) and
[here](https://rust-lang.github.io/rfcs/1946-intra-rustdoc-links.html#additions-to-the-documentation-syntax).
[the rustdoc linking documentation](https://doc.rust-lang.org/rustdoc/write-documentation/linking-to-items-by-name.html#valid-links) and
[the RFC on intra-doc links](https://rust-lang.github.io/rfcs/1946-intra-rustdoc-links.html#additions-to-the-documentation-syntax).
In other words, avoid `` `some_func` `` and instead use ``[`some_func`]``.
> While you are linking, you might become conscious of the fact that you are in need of linking to (too many) foreign
@@ -127,8 +127,8 @@ proc macro crate, but often will no longer function when these proc macros are r
The exception is doc links to *other proc macros* which will function just fine if they are also being re-exported. It
is also often necessary to disambiguate between a proc macro and a function of the same name, which can be done using
the `macro@my_macro_name` syntax in your link. Read more about how to correctly use links in your rust-docs
[here](https://doc.rust-lang.org/rustdoc/write-documentation/linking-to-items-by-name.html#valid-links) and
[here](https://rust-lang.github.io/rfcs/1946-intra-rustdoc-links.html#additions-to-the-documentation-syntax).
[the rustdoc linking documentation](https://doc.rust-lang.org/rustdoc/write-documentation/linking-to-items-by-name.html#valid-links) and
[the RFC on intra-doc links](https://rust-lang.github.io/rfcs/1946-intra-rustdoc-links.html#additions-to-the-documentation-syntax).
---
+1 -1
View File
@@ -129,7 +129,7 @@ Chain syncing will utilize all available memory and CPU power your server has to
If running on a low resource VPS, use `--memory` and `--cpus` to limit the resources used. E.g. To allow a maximum of
512MB memory and 50% of 1 CPU, use `--cpus=".5" --memory="512m"`. Read more about limiting a container's resources
[here](https://docs.docker.com/config/containers/resource_constraints).
[Docker resource constraints documentation](https://docs.docker.com/config/containers/resource_constraints).
## Build your own image
+1 -1
View File
@@ -8,7 +8,7 @@ machine. It can also be setup as [pre-commit hook](https://github.com/igorshubov
to ensure that your markdown is passing all the tests.
The rules in place are defined
[here](https://github.com/pezkuwichain/pezkuwi-sdk/blob/master/.github/.markdownlint.yaml).
[the markdownlint configuration](https://github.com/pezkuwichain/pezkuwi-sdk/blob/master/.github/.markdownlint.yaml).
You may run `markdownlint` locally using:
```