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

[improve docs]: Template pallet #1280

Merged
merged 13 commits into from
Sep 2, 2023
Merged

Conversation

sacha-l
Copy link
Contributor

@sacha-l sacha-l commented Aug 29, 2023

This PR makes improvements to the Template pallet's documentation. This is one of the most common pallets anyone starting with FRAME runtime development sees (it's the upstream source of truth for the Substrate node template).

Screenshot 2023-08-29 at 9 13 11 PM

Exceptionally, it does not follow the Documentation guidelines as it services a different audience than developers looking to understand how to use the pallet. Therefore I omitted an "Examples" section in favour of a description of each pallet section with links to the Substrate docs hub.

It also adds a lot more comments and documentation throughout the pallet code.

@sacha-l sacha-l added A1-insubstantial Pull request requires no code review (e.g., a sub-repository hash update). T11-documentation This PR/Issue is related to documentation. labels Aug 29, 2023
Co-authored-by: Squirrel <gilescope@gmail.com>
@paritytech-cicd-pr
Copy link

The CI pipeline was cancelled due to failure one of the required jobs.
Job name: cargo-clippy
Logs: https://gitlab.parity.io/parity/mirrors/polkadot-sdk/-/jobs/3512778

@sacha-l sacha-l enabled auto-merge (squash) August 31, 2023 13:26
@sacha-l sacha-l merged commit 8cfaad4 into master Sep 2, 2023
6 checks passed
@sacha-l sacha-l deleted the sl/template-pallet-docs-refactor branch September 2, 2023 00:34
ordian added a commit that referenced this pull request Sep 7, 2023
* master: (25 commits)
  Markdown linter (#1309)
  Update `fmt` file and some authors (#1379)
  Bump the known_good_semver group with 1 update (#1375)
  Bump proc-macro-warning from 0.4.1 to 0.4.2 (#1376)
  feat: add futures api to `TransactionPool` (#1348)
  Ensure cumulus/bridges is ignored by formatter and run it (#1369)
  substrate: chain-spec paths corrected in zombienet tests (#1362)
  contracts: Update to wasmi 0.31 (#1350)
  [improve docs]: Template pallet (#1280)
  [xcm-emulator] Unignore cumulus integration tests (#1247)
  Fix wrong ref counting (#1358)
  Use cached session index to obtain executor params (#1190)
  fix typos (#1339)
  Use bandersnatch-vrfs with locked dependencies ref (#1342)
  Bump bs58 from 0.4.0 to 0.5.0 (#1293)
  Contracts: `seal0::balance` should return the free balance (#1254)
  Logs: add extra debug log for negative rep changes (#1205)
  Added short-benchmarks for cumulus (#1183)
  [xcm-emulator] Improve hygiene and clean up (#1301)
  Bump the known_good_semver group with 1 update (#1347)
  ...
Daanvdplas pushed a commit that referenced this pull request Sep 11, 2023
* add and refactor docs

* commit mistake

* improvements

* fixes

* Apply suggestions from code review

Co-authored-by: Squirrel <gilescope@gmail.com>

* fix: use markdown syntax

* from review: explain what generate_deposit does

* from review: add note about errors

* updates

* fix: bring back getter

---------

Co-authored-by: Squirrel <gilescope@gmail.com>
bgallois pushed a commit to duniter/duniter-polkadot-sdk that referenced this pull request Mar 25, 2024
* add and refactor docs

* commit mistake

* improvements

* fixes

* Apply suggestions from code review

Co-authored-by: Squirrel <gilescope@gmail.com>

* fix: use markdown syntax

* from review: explain what generate_deposit does

* from review: add note about errors

* updates

* fix: bring back getter

---------

Co-authored-by: Squirrel <gilescope@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A1-insubstantial Pull request requires no code review (e.g., a sub-repository hash update). T11-documentation This PR/Issue is related to documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants