Mention in builder docs other design goalv/0.20.0-beta1

1 files changed, 5 insertions, 1 deletions

diff --git a/rustls/src/builder.rs b/rustls/src/builder.rs
index f6753f07..9b7cb67e 100644
--- a/rustls/src/builder.rs
+++ b/rustls/src/builder.rs
@@ -5,12 +5,16 @@ use crate::versions;
 
 use std::marker::PhantomData;
 
-/// Building a [`ServerConfig`] or [`ClientConfig`] in a linker-friendly way.
+/// Building a [`ServerConfig`] or [`ClientConfig`] in a linker-friendly and
+/// complete way.
 ///
 /// Linker-friendly: meaning unused cipher suites, protocol
 /// versions, key exchange mechanisms, etc. can be discarded
 /// by the linker as they'll be unreferenced.
 ///
+/// Complete: the type system ensures all decisions required to run a
+/// server or client have been made by the time the process finishes.
+///
 /// Example, to make a [`ServerConfig`]:
 ///
 /// ```no_run