docs: further doc improvements

CHANGELOG

@@ -1,3 +1,6 @@
+## v1.0.4 - Docs Improved II
+Further improved documentation
+
 ## v1.0.3 - Docs Improved
 More examples
 

Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "webcryptobox"
 description = "Convenient wrappers around OpenSSL to use WebCrypto compatible cryptography."
-version = "1.0.3"
+version = "1.0.4"
 edition = "2021"
 documentation = "https://docs.rs/webcryptobox/latest/webcryptobox/"
 homepage = "https://github.com/jo/webcryptobox-rs"

README.md

@@ -1,11 +1,11 @@
 # Webcryptobox
-Webcryptobox provides convenient wrappers around OpenSSL to use WebCrypto compatible cryptography.
+Convenient wrappers around [OpenSSL](https://docs.rs/openssl/latest/openssl/) to use [WebCrypto](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API) compatible cryptography.
 
 It works nicely together with the [JavaScript Webcryptobox](https://github.com/jo/webcryptobox-js) and [Bash Webcryptobox](https://github.com/jo/webcryptobox-sh).
 
-Webcryptobox provides functions for elliptic curve key generation, derivation, import and export as well as AES encryption and decryption.
+Webcryptobox is **both a library and a little command line interface.** It helps with elliptic curve key generation, derivation, fingerprinting, import and export as well as AES encryption and decryption.
 
-Webcryptobox comes with both a library and a little command line interface. For the library documentation, see [docs.rs/webcryptobox](https://docs.rs/webcryptobox/latest/webcryptobox/). In the following I describe the CLI usage.
+For the library documentation, see [docs.rs/webcryptobox](https://docs.rs/webcryptobox/latest/webcryptobox/). In the following I describe the CLI usage.
 
 ## Installation
 Clone the project, compile it and use the binary:

src/lib.rs

@@ -1,9 +1,16 @@
-//! Webcryptobox provides convenient wrappers around OpenSSL to use WebCrypto compatible
+#![warn(missing_docs)]
+#![warn(rustdoc::missing_doc_code_examples)]
+
+//! Webcryptobox provides convenient wrappers around
+//! [OpenSSL](https://docs.rs/openssl/latest/openssl/) to use
+//! [WebCrypto](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API) compatible
 //! cryptography.
 //!
-//! It works nicely together with the [JavaScript Webcryptobox](https://github.com/jo/webcryptobox-js).
+//! It works nicely together with the [JavaScript
+//! Webcryptobox](https://github.com/jo/webcryptobox-js) and [Bash
+//! Webcryptobox](https://github.com/jo/webcryptobox-sh).
 //!
-//! Webcryptobox provides functions for elliptic curve key generation, derivation, import and
+//! Webcryptobox helps with elliptic curve key generation, derivation, fingerprinting, import and
 //! export as well as AES encryption and decryption.
 
 use openssl::derive::Deriver;
@@ -16,9 +23,11 @@ use openssl::rand::rand_bytes;
 use openssl::sha;
 use openssl::symm;
 
+// Length of the AEAD tag used in GCM mode
 const AEAD_TAG_LENGTH: usize = 16;
 
-/// Holds cipher configuration and provides the methods for dancing with elliptic curves and advanced encryption.
+/// Holds cipher configuration and provides the methods for dancing with elliptic curves and
+/// advanced encryption.
 ///
 /// Use the factories [`webcryptobox::Webcryptobox::new`] or
 /// [`webcryptobox::Webcryptobox::default`] to instantiate a Webcryptobox: