add some review suggestions

paritytech · Nov 24, 2023 · 44ebcf2 · 44ebcf2
1 parent 1955b38
commit 44ebcf2
Show file tree

Hide file tree

Showing 4 changed files with 7 additions and 6 deletions.
diff --git a/developer-hub/src/polkadot_sdk/frame_runtime.rs b/developer-hub/src/polkadot_sdk/frame_runtime.rs
@@ -40,8 +40,8 @@
 //! - [Config](frame::pallet_macros::config), allowing a pallet to make itself configurable and
 //!   generic over types, values and such.
 //! - [Storage](frame::pallet_macros::storage), allowing a pallet to define onchain storage.
-//! - [Dispatchable function aka. Extrinsics](frame::pallet_macros::call), allowing a pallet to
-//!   define extrinsics that are callable by end users, from the outer world.
+//! - [Dispatchable function](frame::pallet_macros::call), allowing a pallet to define extrinsics
+//!   that are callable by end users, from the outer world.
 //! - [Events](frame::pallet_macros::event), allowing a pallet to emit events.
 //! - [Errors](frame::pallet_macros::error), allowing a pallet to emit well-formed errors.
 //!

diff --git a/developer-hub/src/polkadot_sdk/mod.rs b/developer-hub/src/polkadot_sdk/mod.rs
@@ -16,8 +16,8 @@
 //!
 //! ## Getting Started
 //!
-//! The primary way to get started with the Polkadot SDK is to start writing a Substrate-based
-//! runtime using FRAME. See:
+//! The primary way to get started with the Polkadot SDK is to start writing a FRAME-based runtime.
+//! See:
 //!
 //! * [`polkadot`], to understand what is Polkadot as a development platform.
 //! * [`substrate`], for an overview of what Substrate as the main blockchain framework of Polkadot

diff --git a/developer-hub/src/polkadot_sdk/polkadot.rs b/developer-hub/src/polkadot_sdk/polkadot.rs
@@ -2,12 +2,13 @@
 //!
 //! Implementation of the Polkadot node/host in Rust.
 //!
-//! ## Getting Involved
+//! ## Learn More and Get Involved
 //!
 //! - [Polkadot Forum](https://forum.polkadot.network/)
 //! - [Polkadot Parachains](https://parachains.info/)
 //! - [Polkadot (multi-chain) Explorer](https://subscan.io/)
 //! - Polkadot Fellowship
+//!     - [Manifesto](https://github.com/polkadot-fellows/manifesto)
 //!     - [Runtimes](https://github.com/polkadot-fellows/runtimes)
 //!     - [RFCs](https://github.com/polkadot-fellows/rfcs)
 //! - [Polkadot Specs](spec.polkadot.network)

diff --git a/developer-hub/src/reference_docs/wasm_meta_protocol.rs b/developer-hub/src/reference_docs/wasm_meta_protocol.rs
@@ -16,7 +16,7 @@
 //! [`crate::reference_docs::blockchain_state_machines`], this state transition function is called
 //! the **Runtime**, and WASM is chosen as the bytecode. The Runtime is stored under a special key
 //! in the state (see
-//! [`sp_core::storage::well_known_keys`](../../../target/doc/sp_core/index.html)), and can be
+//! [`sp_core::storage::well_known_keys`](../../../sp_core/index.html)) and can be
 //! updated as a part of the state transition function's execution, just like a user's account
 //! balance can be updated.
 //!