difftreelog
doc(rmrk): minor edits for clarity
in: master
2 files changed
pallets/proxy-rmrk-core/src/lib.rsdiffbeforeafterboth--- a/pallets/proxy-rmrk-core/src/lib.rs
+++ b/pallets/proxy-rmrk-core/src/lib.rs
@@ -67,7 +67,7 @@
//! Parts are defined in the Base to which they belong. Parts can be either
//! of the `slot` type or `fixed` type. Slots are intended for equippables.
//! Note that "part of something" and "Part of a Base" can be easily confused,
-//! and in this documentation these words are distinguished by the capital letter.
+//! and so in this documentation these words are distinguished by the capital letter.
//!
//! - **Theme:** Named objects of variable => value pairs which get interpolated into
//! the Base's `themable` Parts. Themes can hold any value, but are often represented
@@ -78,9 +78,9 @@
//! - **Scoped properties:** Properties that are normally obscured from users.
//! Their purpose is to contain structured metadata that was not included in the Unique standard
//! for collections and tokens, meant to be operated on by proxies and other outliers.
-//! Scoped properties are prefixed with `some-scope:`, where `some-scope` is
-//! an arbitrary keyword, like "rmrk", and `:` is an unacceptable symbol in user-defined
-//! properties, which, along with other safeguards, makes them impossible to tamper with.
+//! Scoped property keys are prefixed with `some-scope:`, where `some-scope` is
+//! an arbitrary keyword, like "rmrk". `:` is considered an unacceptable symbol in user-defined
+//! properties, which, along with other safeguards, makes scoped ones impossible to tamper with.
//!
//! - **Auxiliary properties:** A slightly different structure of properties,
//! trading universality of use for more convenient storage, writes and access.
@@ -91,7 +91,7 @@
//! An external user is supposed to be able to utilize this proxy as they would
//! utilize RMRK, and get exactly the same results. Normally, Unique transactions
//! are off-limits to RMRK collections and tokens, and vice versa. However,
-//! the information stored on chain can be freely interpreted by storage reads and RPCs.
+//! the information stored on chain can be freely interpreted by storage reads and Unique RPCs.
//!
//! ### ID Mapping
//!
@@ -115,10 +115,10 @@
//!
//! ### Collection and NFT Types, and Base, Parts and Themes Handling
//!
-//! RMRK introduces the concept of a Base, which is a catalgoue of Parts,
+//! RMRK introduces the concept of a Base, which is a catalogue of Parts,
//! possible components of an NFT. Due to its similarity with the functionality
//! of a token collection, a Base is stored and handled as one, and the Base's Parts and Themes
-//! are the collection's NFTs. See [`CollectionType`] and [`NftType`].
+//! are this collection's NFTs. See [`CollectionType`] and [`NftType`].
//!
//! ## Interface
//!
pallets/proxy-rmrk-equip/src/lib.rsdiffbeforeafterboth70//! Parts are defined in the Base to which they belong. Parts can be either70//! Parts are defined in the Base to which they belong. Parts can be either71//! of the `slot` type or `fixed` type. Slots are intended for equippables.71//! of the `slot` type or `fixed` type. Slots are intended for equippables.72//! Note that "part of something" and "Part of a Base" can be easily confused,72//! Note that "part of something" and "Part of a Base" can be easily confused,73//! and in this documentation these words are distinguished by the capital letter.73//! and so in this documentation these words are distinguished by the capital letter.74//!74//!75//! - **Theme:** Named objects of variable => value pairs which get interpolated into75//! - **Theme:** Named objects of variable => value pairs which get interpolated into76//! the Base's `themable` Parts. Themes can hold any value, but are often represented76//! the Base's `themable` Parts. Themes can hold any value, but are often represented81//! - **Scoped properties:** Properties that are normally obscured from users.81//! - **Scoped properties:** Properties that are normally obscured from users.82//! Their purpose is to contain structured metadata that was not included in the Unique standard82//! Their purpose is to contain structured metadata that was not included in the Unique standard83//! for collections and tokens, meant to be operated on by proxies and other outliers.83//! for collections and tokens, meant to be operated on by proxies and other outliers.84//! Scoped properties are prefixed with `some-scope:`, where `some-scope` is84//! Scoped property keys are prefixed with `some-scope:`, where `some-scope` is85//! an arbitrary keyword, like "rmrk", and `:` is an unacceptable symbol in user-defined85//! an arbitrary keyword, like "rmrk". `:` is considered an unacceptable symbol in user-defined86//! properties, which, along with other safeguards, makes them impossible to tamper with.86//! properties, which, along with other safeguards, makes scoped ones impossible to tamper with.87//!87//!88//! - **Auxiliary properties:** A slightly different structure of properties,88//! - **Auxiliary properties:** A slightly different structure of properties,89//! trading universality of use for more convenient storage, writes and access.89//! trading universality of use for more convenient storage, writes and access.94//! An external user is supposed to be able to utilize this proxy as they would94//! An external user is supposed to be able to utilize this proxy as they would95//! utilize RMRK, and get exactly the same results. Normally, Unique transactions95//! utilize RMRK, and get exactly the same results. Normally, Unique transactions96//! are off-limits to RMRK collections and tokens, and vice versa. However,96//! are off-limits to RMRK collections and tokens, and vice versa. However,97//! the information stored on chain can be freely interpreted by storage reads and RPCs.97//! the information stored on chain can be freely interpreted by storage reads and Unique RPCs.98//!98//!99//! ### ID Mapping99//! ### ID Mapping100//!100//!118//!118//!119//! ### Collection and NFT Types, and Base, Parts and Themes Handling119//! ### Collection and NFT Types, and Base, Parts and Themes Handling120//!120//!121//! RMRK introduces the concept of a Base, which is a catalgoue of Parts,121//! RMRK introduces the concept of a Base, which is a catalogue of Parts,122//! possible components of an NFT. Due to its similarity with the functionality122//! possible components of an NFT. Due to its similarity with the functionality123//! of a token collection, a Base is stored and handled as one, and the Base's Parts and Themes123//! of a token collection, a Base is stored and handled as one, and the Base's Parts and Themes124//! are the collection's NFTs. See [`CollectionType`] and [`NftType`].124//! are this collection's NFTs. See [`CollectionType`] and [`NftType`].125//!125//!126//! ## Interface126//! ## Interface127//!127//!