-
Notifications
You must be signed in to change notification settings - Fork 796
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
chain-spec
/presets reference docs added
#4678
Conversation
chain-spec
/prestets reference docs added
chain-spec
/prestets reference docs addedchain-spec
/presets reference docs added
Co-authored-by: Alexandru Vasile <60601340+lexnv@users.noreply.github.com>
The CI pipeline was cancelled due to failure one of the required jobs. |
const CHAIN_SPEC_BUILDER_PATH: &str = "../../../../../target/release/chain-spec-builder"; | ||
|
||
fn get_chain_spec_builder_path() -> &'static str { | ||
// dev-dependencies do not build binary. So let's do the naive work-around here: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I have been brainstorming with how e can format this nicely into the docs with @rzadp, and the outcome is sam0x17/docify#26
docs/sdk/src/reference_docs/chain_spec_runtime/tests/chain_spec_builder_tests.rs
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
All in all, this is a superb documentation, very aligned with how it should be.
I hope you can testify that writing this is mostly writing new e2e tests that in general ensure the code you are writing is correct. The doc part is a small part of it that we extract.
I hope to see more important APIs to be written like this from day-zero, with documentation in mind. A lot of the e2e testing and then actually live inside the polkadot-sdk-docs
crate.
Some nitpicks pointed out, but all in all looks great.
This motivates me also bring #3946 up to date and merge it.
Co-authored-by: Sebastian Kunert <skunert49@gmail.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice!
Added reference doc about: - the pallet genesis config and genesis build, - runtime `genesis-builder` API, - presets, - interacting with the `chain-spec-builder` tool I've added [minimal runtime](https://github.com/paritytech/polkadot-sdk/tree/mku-chain-spec-guide/docs/sdk/src/reference_docs/chain_spec_runtime) to demonstrate above topics. I also sneaked in some little improvement to `chain-spec-builder` which allows to parse output of the `list-presets` command. --------- Co-authored-by: Alexandru Vasile <60601340+lexnv@users.noreply.github.com> Co-authored-by: Sebastian Kunert <skunert49@gmail.com>
Added reference doc about: - the pallet genesis config and genesis build, - runtime `genesis-builder` API, - presets, - interacting with the `chain-spec-builder` tool I've added [minimal runtime](https://github.com/paritytech/polkadot-sdk/tree/mku-chain-spec-guide/docs/sdk/src/reference_docs/chain_spec_runtime) to demonstrate above topics. I also sneaked in some little improvement to `chain-spec-builder` which allows to parse output of the `list-presets` command. --------- Co-authored-by: Alexandru Vasile <60601340+lexnv@users.noreply.github.com> Co-authored-by: Sebastian Kunert <skunert49@gmail.com>
Added reference doc about: - the pallet genesis config and genesis build, - runtime `genesis-builder` API, - presets, - interacting with the `chain-spec-builder` tool I've added [minimal runtime](https://github.com/paritytech/polkadot-sdk/tree/mku-chain-spec-guide/docs/sdk/src/reference_docs/chain_spec_runtime) to demonstrate above topics. I also sneaked in some little improvement to `chain-spec-builder` which allows to parse output of the `list-presets` command. --------- Co-authored-by: Alexandru Vasile <60601340+lexnv@users.noreply.github.com> Co-authored-by: Sebastian Kunert <skunert49@gmail.com>
Added reference doc about:
genesis-builder
API,chain-spec-builder
toolI've added minimal runtime to demonstrate above topics.
I also sneaked in some little improvement to
chain-spec-builder
which allows to parse output of thelist-presets
command.