Add doc links to main doc and formatting

time/src/format_description/mod.rs

@@ -3,6 +3,9 @@
 //! The formatted value will be output to the provided writer. Format descriptions can be
 //! [well-known](crate::format_description::well_known) or obtained by using the
 //! [`format_description!`](crate::macros::format_description) macro or a function listed below.
+//!
+//! For examples, see the implementors of [Formattable](crate::formatting::Formattable),
+//! e.g. [well_known::Rfc3339].
 
 mod borrowed_format_item;
 mod component;

time/src/formatting/formattable.rs

@@ -11,7 +11,12 @@ use crate::formatting::{
 };
 use crate::{error, Date, Time, UtcOffset};
 
-/// A type that can be formatted.
+/// A type that describes a format.
+///
+/// Implementors of [Formattable] are [format descriptions](crate::format_description).
+///
+/// [Date::format] and [Time::format] each use a format description to generate
+/// a String from their data. See the respective methods for usage examples.
 #[cfg_attr(__time_03_docs, doc(notable_trait))]
 pub trait Formattable: sealed::Sealed {}
 impl Formattable for FormatItem<'_> {}

time/src/lib.rs

@@ -1,3 +1,7 @@
+//! A safe date and time library for Rust.
+//!
+//! [The book] is the main documentation for `time`.
+//!
 //! # Feature flags
 //!
 //! This crate exposes a number of features. These can be enabled or disabled as shown