mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-07-06 23:07:22 +00:00
Markdown linter (#1309)
* Add markdown linting - add linter default rules - adapt rules to current code - fix the code for linting to pass - add CI check fix #1243 * Fix markdown for Substrate * Fix tooling install * Fix workflow * Add documentation * Remove trailing spaces * Update .github/.markdownlint.yaml Co-authored-by: Oliver Tale-Yazdi <oliver.tale-yazdi@parity.io> * Fix mangled markdown/lists * Fix captalization issues on known words
This commit is contained in:
@@ -2,11 +2,11 @@
|
||||
|
||||
This module is responsible for managing shared storage and configuration for other modules.
|
||||
|
||||
It is important that other pallets are able to use the Shared Module, so it should not have a
|
||||
dependency on any other modules in the Parachains Runtime.
|
||||
It is important that other pallets are able to use the Shared Module, so it should not have a dependency on any other
|
||||
modules in the Parachains Runtime.
|
||||
|
||||
For the moment, it is used exclusively to track the current session index across the Parachains
|
||||
Runtime system, and when it should be allowed to schedule future changes to Paras or Configurations.
|
||||
For the moment, it is used exclusively to track the current session index across the Parachains Runtime system, and when
|
||||
it should be allowed to schedule future changes to Paras or Configurations.
|
||||
|
||||
## Constants
|
||||
|
||||
@@ -57,24 +57,26 @@ AllowedRelayParents: AllowedRelayParentsTracker<T::Hash, T::BlockNumber>,
|
||||
|
||||
The Shared Module currently has no initialization routines.
|
||||
|
||||
The Shared Module is initialized directly after the Configuration module, but before all other
|
||||
modules. It is important to update the Shared Module before any other module since its state may be
|
||||
used within the logic of other modules, and it is important that the state is consistent across
|
||||
them.
|
||||
The Shared Module is initialized directly after the Configuration module, but before all other modules. It is important
|
||||
to update the Shared Module before any other module since its state may be used within the logic of other modules, and
|
||||
it is important that the state is consistent across them.
|
||||
|
||||
## Session Change
|
||||
|
||||
During a session change, the Shared Module receives and stores the current Session Index directly from the initializer module, along with the broader validator set, and it returns the new list of validators.
|
||||
During a session change, the Shared Module receives and stores the current Session Index directly from the initializer
|
||||
module, along with the broader validator set, and it returns the new list of validators.
|
||||
|
||||
The list of validators should be first shuffled according to the chain's random seed and then truncated. The indices of these validators should be set to `ActiveValidatorIndices` and then returned back to the initializer. `ActiveValidatorKeys` should be set accordingly.
|
||||
The list of validators should be first shuffled according to the chain's random seed and then truncated. The indices of
|
||||
these validators should be set to `ActiveValidatorIndices` and then returned back to the initializer.
|
||||
`ActiveValidatorKeys` should be set accordingly.
|
||||
|
||||
This information is used in the:
|
||||
|
||||
* Configuration Module: For delaying updates to configurations until at lease one full session has
|
||||
passed.
|
||||
* Configuration Module: For delaying updates to configurations until at lease one full session has passed.
|
||||
* Paras Module: For delaying updates to paras until at least one full session has passed.
|
||||
|
||||
Allowed relay parents buffer, which is maintained by [ParaInherent](./parainherent.md) module, is cleared on every session change.
|
||||
Allowed relay parents buffer, which is maintained by [ParaInherent](./parainherent.md) module, is cleared on every
|
||||
session change.
|
||||
|
||||
## Finalization
|
||||
|
||||
@@ -82,6 +84,6 @@ The Shared Module currently has no finalization routines.
|
||||
|
||||
## Functions
|
||||
|
||||
* `scheduled_sessions() -> SessionIndex`: Return the next session index where updates to the
|
||||
Parachains Runtime system would be safe to apply.
|
||||
* `scheduled_sessions() -> SessionIndex`: Return the next session index where updates to the Parachains Runtime system
|
||||
would be safe to apply.
|
||||
* `set_session_index(SessionIndex)`: For tests. Set the current session index in the Shared Module.
|
||||
|
||||
Reference in New Issue
Block a user