docs: Ensure the CI passes for docs (#2666)

* Fix docs

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* Update client/relay-chain-rpc-interface/src/reconnecting_ws_client.rs

Co-authored-by: Davide Galassi <davxy@datawok.net>

* Update cargo.lock with substrate

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* Update Cargo.lock for polkadot

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

---------

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>
Co-authored-by: Davide Galassi <davxy@datawok.net>
Co-authored-by: parity-processbot <>

Author: lexnv

client/relay-chain-rpc-interface/src/reconnecting_ws_client.rs

@@ -161,7 +161,9 @@ impl ReconnectingWsClient {
 	}
 }
 
-/// Worker that should be used in combination with [`RelayChainRpcClient`]. Must be polled to distribute header notifications to listeners.
+/// Worker that should be used in combination with [`crate::RelayChainRpcClient`].
+///
+/// Must be polled to distribute header notifications to listeners.
 struct ReconnectingWebsocketWorker {
 	ws_urls: Vec<String>,
 	/// Communication channel with the RPC client

pallets/parachain-system/src/lib.rs

@@ -692,7 +692,7 @@ pub mod pallet {
 
 	/// A custom head data that should be returned as result of `validate_block`.
 	///
-	/// See [`Pallet::set_custom_validation_head_data`] for more information.
+	/// See `Pallet::set_custom_validation_head_data` for more information.
 	#[pallet::storage]
 	pub(super) type CustomValidationHeadData<T: Config> = StorageValue<_, Vec<u8>, OptionQuery>;
 
@@ -872,7 +872,7 @@ impl<T: Config> Pallet<T> {
 
 	/// Process all inbound horizontal messages relayed by the collator.
 	///
-	/// This is similar to [`process_inbound_downward_messages`], but works on multiple inbound
+	/// This is similar to `Pallet::process_inbound_downward_messages`, but works on multiple inbound
 	/// channels.
 	///
 	/// **Panics** if either any of horizontal messages submitted by the collator was sent from