diff --git a/src/blocks/header.rs b/src/blocks/header.rs
new file mode 100644
index 0000000..938ee24
--- /dev/null
+++ b/src/blocks/header.rs
@@ -0,0 +1,203 @@
+//! # Header Block
+//!
+//! [slack api docs 🔗]
+//!
+//! A header is a plain-text block that displays in a larger, bold font.
+//!
+//! Use it to delineate between different groups of content in your app's surfaces.
+//!
+//! [slack api docs 🔗]: https://api.slack.com/reference/block-kit/blocks#header
+
+use std::borrow::Cow;
+
+use serde::{Deserialize, Serialize};
+#[cfg(feature = "validation")]
+use validator::Validate;
+
+use crate::text;
+#[cfg(feature = "validation")]
+use crate::val_helpr::*;
+
+/// # Header Block
+///
+/// [slack api docs 🔗]
+///
+/// A header is a plain-text block that displays in a larger, bold font.
+///
+/// Use it to delineate between different groups of content in your app's surfaces.
+///
+/// [slack api docs 🔗]: https://api.slack.com/reference/block-kit/blocks#header
+#[derive(Clone, Debug, Deserialize, Hash, PartialEq, Serialize)]
+#[cfg_attr(feature = "validation", derive(Validate))]
+pub struct Header<'a> {
+  #[cfg_attr(feature = "validation", validate(custom = "validate_text"))]
+  text: text::Text,
+
+  #[serde(skip_serializing_if = "Option::is_none")]
+  #[cfg_attr(feature = "validation",
+             validate(custom = "super::validate_block_id"))]
+  block_id: Option<Cow<'a, str>>,
+}
+
+#[cfg(feature = "validation")]
+fn validate_text(t: &text::Text) -> ValidatorResult {
+  below_len("text", 150, t)
+}
+
+impl<'a> Header<'a> {
+  /// Build a new Header block.
+  ///
+  /// Alias for [`build::HeaderBuilder::new()`].
+  pub fn builder() -> build::HeaderBuilderInit<'a> {
+    build::HeaderBuilder::new()
+  }
+
+  /// Validate that this Header block agrees with Slack's model requirements
+  ///
+  /// # Errors
+  /// - If `text` longer than 150 chars
+  /// - If `block_id` longer than 256 chars
+  ///
+  /// # Example
+  /// ```
+  /// # use validator::Validate;
+  /// use slack_blocks::{blocks::Header, compose};
+  ///
+  /// let long_string = |len| std::iter::repeat(' ').take(len).collect::<String>();
+  /// let assert_invalid = |block: &dyn Validate| match block.validate() {
+  ///   | Ok(()) => panic!("validation should have failed"),
+  ///   | Err(_) => (),
+  /// };
+  ///
+  /// // block_id
+  /// let block = Header::builder().text("foo")
+  ///                              .block_id(long_string(256))
+  ///                              .build();
+  ///
+  /// assert_invalid(&block);
+  ///
+  /// // text
+  /// let block = Header::builder().text(long_string(151))
+  ///                              .block_id("foo")
+  ///                              .build();
+  ///
+  /// assert_invalid(&block);
+  /// ```
+  #[cfg(feature = "validation")]
+  #[cfg_attr(docsrs, doc(cfg(feature = "validation")))]
+  pub fn validate(&self) -> ValidationResult {
+    todo!()
+  }
+}
+
+pub mod build {
+  //! [HeaderBuilder] and related items
+
+  use std::marker::PhantomData;
+
+  use super::*;
+  use crate::build::*;
+
+  /// Methods of [`HeaderBuilder`]
+  #[allow(non_camel_case_types)]
+  pub mod method {
+    /// [`super::HeaderBuilder::text()`]
+    #[derive(Debug, Clone, Copy)]
+    pub struct text;
+  }
+
+  /// Initial state for [HeaderBuilder]
+  pub type HeaderBuilderInit<'a> =
+    HeaderBuilder<'a, RequiredMethodNotCalled<method::text>>;
+
+  /// Build an Header block
+  ///
+  /// Allows you to construct safely, with compile-time checks
+  /// on required setter methods.
+  ///
+  /// # Required Methods
+  /// `HeaderBuilder::build()` is only available if these methods have been called:
+  ///  - `text`
+  ///
+  /// # Example
+  /// ```
+  /// use slack_blocks::blocks::Header;
+  ///
+  /// let block = Header::builder().block_id("foo").text("bar").build();
+  /// ```
+  #[derive(Clone, Debug)]
+  pub struct HeaderBuilder<'a, T> {
+    text: Option<text::Text>,
+    block_id: Option<Cow<'a, str>>,
+    state: PhantomData<T>,
+  }
+
+  impl<'a, T> HeaderBuilder<'a, T> {
+    /// Construct a new HeaderBuilder
+    pub fn new() -> Self {
+      Self { text: None,
+             block_id: None,
+             state: PhantomData::<_> }
+    }
+
+    /// Set `text` (**Required**)
+    ///
+    /// The text for the block, in the form of a [`plain_text` text object 🔗].
+    ///
+    /// Maximum length for the `text` in this field is 150 characters.
+    ///
+    /// [`plain_text` text object 🔗]: https://api.slack.com/reference/messaging/composition-objects#text
+    pub fn text(self,
+                text: impl Into<text::Plain>)
+                -> HeaderBuilder<'a, Set<method::text>> {
+      HeaderBuilder { text: Some(text.into().into()),
+                      block_id: self.block_id,
+                      state: PhantomData::<_> }
+    }
+
+    /// XML child alias for [`Self::text()`]
+    #[cfg(feature = "blox")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "blox")))]
+    pub fn child(self,
+                 text: impl Into<text::Plain>)
+                 -> HeaderBuilder<'a, Set<method::text>> {
+      self.text(text)
+    }
+
+    /// A string acting as a unique identifier for a block.
+    ///
+    /// If not specified, one will be generated.
+    ///
+    /// Maximum length for this field is 255 characters.
+    /// `block_id` should be unique for each message and each iteration of a message.
+    ///
+    /// If a message is updated, use a new `block_id`.
+    pub fn block_id(mut self, block_id: impl Into<Cow<'a, str>>) -> Self {
+      self.block_id = Some(block_id.into());
+      self
+    }
+  }
+
+  impl<'a> HeaderBuilder<'a, Set<method::text>> {
+    /// All done building, now give me a darn actions block!
+    ///
+    /// > `no method name 'build' found for struct 'FileBuilder<...>'`?
+    /// Make sure all required setter methods have been called. See docs for `FileBuilder`.
+    ///
+    /// ```compile_fail
+    /// use slack_blocks::blocks::Header;
+    ///
+    /// let foo = Header::builder().build(); // Won't compile!
+    /// ```
+    ///
+    /// ```
+    /// use slack_blocks::blocks::Header;
+    ///
+    /// let block = Header::builder().text("Foo").build();
+    /// ```
+    pub fn build(self) -> Header<'a> {
+      Header { text: self.text.unwrap(),
+               block_id: self.block_id }
+    }
+  }
+}
diff --git a/src/blocks/mod.rs b/src/blocks/mod.rs
index fe72b75..386631a 100644
--- a/src/blocks/mod.rs
+++ b/src/blocks/mod.rs
@@ -15,36 +15,34 @@ use serde::{Deserialize, Serialize};
 
 use crate::convert;
 
-#[doc(inline)]
 pub mod actions;
 #[doc(inline)]
 pub use actions::Actions;
 
-#[doc(inline)]
 pub mod context;
 #[doc(inline)]
 pub use context::Context;
 
-#[doc(inline)]
 pub mod file;
 #[doc(inline)]
 pub use file::File;
 
-#[doc(inline)]
 pub mod image;
 #[doc(inline)]
 pub use image::Image;
 
-#[doc(inline)]
 pub mod input;
 #[doc(inline)]
 pub use input::Input;
 
-#[doc(inline)]
 pub mod section;
 #[doc(inline)]
 pub use section::Section;
 
+pub mod header;
+#[doc(inline)]
+pub use header::Header;
+
 /// # Layout Blocks
 ///
 /// Blocks are a series of components that can be combined
@@ -55,7 +53,7 @@ pub use section::Section;
 /// You can include up to 50 blocks in each message, and 100 blocks in modals or home tabs.
 ///
 /// [building block layouts 🔗]: https://api.slack.com/block-kit/building
-#[derive(Serialize, Deserialize, Debug)]
+#[derive(Hash, PartialEq, Serialize, Deserialize, Debug)]
 #[serde(tag = "type", rename_all = "snake_case")]
 pub enum Block<'a> {
   /// # Section Block
@@ -85,6 +83,9 @@ pub enum Block<'a> {
   /// # Input Block
   Input(Input<'a>),
 
+  /// # Input Block
+  Header(Header<'a>),
+
   /// # File Block
   File(File<'a>),
 }
@@ -92,6 +93,7 @@ pub enum Block<'a> {
 impl fmt::Display for Block<'_> {
   fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
     let kind = match self {
+      | Block::Header { .. } => "Header",
       | Block::Section { .. } => "Section",
       | Block::Divider => "Divider",
       | Block::Image { .. } => "Image",
@@ -128,6 +130,7 @@ impl<'a> Block<'a> {
       | Actions(contents) => contents.validate(),
       | Context(contents) => contents.validate(),
       | Input(contents) => contents.validate(),
+      | Header(contents) => contents.validate(),
       | File(contents) => contents.validate(),
       | Divider => Ok(()),
     }
@@ -140,6 +143,7 @@ convert!(impl<'a> From<Section<'a>> for Block<'a> => |a| Block::Section(a));
 convert!(impl<'a> From<Image<'a>>   for Block<'a> => |a| Block::Image(a));
 convert!(impl<'a> From<Context<'a>> for Block<'a> => |a| Block::Context(a));
 convert!(impl<'a> From<File<'a>>    for Block<'a> => |a| Block::File(a));
+convert!(impl<'a> From<Header<'a>>  for Block<'a> => |a| Block::Header(a));
 
 /// Error yielded when `TryFrom` is called on an unsupported block element.
 #[derive(Clone, Debug, Deserialize, Hash, PartialEq, Serialize)]
diff --git a/src/blox.rs b/src/blox.rs
index 93b7e94..103860f 100644
--- a/src/blox.rs
+++ b/src/blox.rs
@@ -1,4 +1,86 @@
 //! # XML macro builder support
+//!
+//! # Blocks
+//!
+//! [`blocks::Actions`] - `<`[`actions_block`]`>`
+//!
+//! [`blocks::Header`] - `<`[`header_block`]`>` or `<`[`h1`]`>`
+//!
+//! [`blocks::Block::Divider`] - `<`[`divider_block`]`>` or `<`[`hr`]`>`
+//!
+//! [`blocks::Section`] - `<`[`section_block`]`>`
+//!
+//! [`blocks::Input`] - `<`[`input_block`]`>`
+//!
+//! [`blocks::Context`] - `<`[`context_block`]`>`
+//!
+//! [`blocks::File`] - `<`[`file_block`]`>`
+//!
+//! [`blocks::Image`] - `<`[`img_block`]`>`
+//!
+//! # Block Elements
+//!
+//! [`elems::TextInput`] - `<`[`text_input`]`>`
+//!
+//! [`elems::Image`] - `<`[`img`]`>`
+//!
+//! [`elems::Button`] - `<`[`button`]`>`
+//!
+//! [`elems::Checkboxes`] - `<`[`checkboxes`]`>`
+//!
+//! [`elems::DatePicker`] - `<`[`date_picker`]`>`
+//!
+//! [`elems::Overflow`] - `<`[`overflow`]`>`
+//!
+//! [`elems::Radio`] - `<`[`radio_buttons`]`>`
+//!
+//! [`elems::select`] - `<`[`select`]`>`
+//!
+//! # Composition Objects
+//!
+//! [`compose::text`] - `<`[`text()`]`>`
+//!
+//! [`compose::opt`] - `<`[`option`]`>`
+//!
+//! [`compose::opt_group`] - `<`[`option_group`]`>`
+//!
+//! [`compose::Confirm`] - `<`[`confirm`]`>`
+//!
+//! # Example
+//! Using an example from Slack's Documentation:
+//! ```json
+//! {
+//!   "type": "section",
+//!   "text": {
+//!     "text": "*Sally* has requested you set the deadline for the Nano launch project",
+//!     "type": "mrkdwn"
+//!   },
+//!   "accessory": {
+//!     "type": "datepicker",
+//!     "action_id": "datepicker123",
+//!     "initial_date": "1990-04-28",
+//!     "placeholder": {
+//!       "type": "plain_text",
+//!       "text": "Select a date"
+//!     }
+//!   }
+//! }
+//! ```
+//! ```rust
+//! use slack_blocks::blox::*;
+//!
+//! let pick_date = blox! {
+//!   <date_picker action_id="datepicker123"
+//!                placeholder="Select a date"
+//!                initial_date=(28, 4, 1990) />
+//! };
+//!
+//! let section = blox! {
+//!   <section_block accessory=pick_date>
+//!     <text kind=plain>"*Sally* has requested you set the deadline for the Nano launch project"</text>
+//!   </section_block>
+//! };
+//! ```
 
 pub use elems::{button::Style::{Danger as btn_danger,
                                 Primary as btn_primary},
@@ -30,10 +112,24 @@ pub use blox_elems::*;
 mod blox_blocks {
   use super::*;
 
-  /// # Build an actions block
+  /// Dummy builder so [blocks::Block::Divider] can be built with XML macro
+  #[derive(Debug, Copy, Clone)]
+  pub struct DividerBuilder;
+  impl DividerBuilder {
+    /// Constructs [blocks::Block::Divider]
+    pub fn build(self) -> blocks::Block<'static> {
+      blocks::Block::Divider
+    }
+  }
+
+  /// # [`blocks::Actions`] - `<actions_block>`
+  ///
+  /// Build a [`blocks::Actions`]
   ///
-  /// ## Children
-  /// Accepts at least one, and up to 5 supported block elements as children.
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`element`](blocks::actions::build::ActionsBuilder::element())|`impl Into<`[`blocks::actions::SupportedElement`]`>`|❌|✅|
+  /// |[`block_id`](blocks::actions::build::ActionsBuilder::block_id())|[`String`] or [`&str`]|✅|❌|
   ///
   /// ## Example
   /// ```
@@ -64,20 +160,101 @@ mod blox_blocks {
     blocks::Actions::builder()
   }
 
-  /// # Build a section block
+  /// # [`blocks::Header`] - `<header_block>` or `<h1>`
+  ///
+  /// Build a [`blocks::Header`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`text`](blocks::header::build::HeaderBuilder::text())|[`text::Plain`], [`String`], [`&str`]|❌|✅|
+  /// |[`block_id`](blocks::header::build::HeaderBuilder::block_id())|[`String`] or [`&str`]|✅|❌|
+  ///
+  /// ## Example
+  /// ```
+  /// use slack_blocks::{blocks::Header, blox::*};
+  ///
+  /// let xml = blox! {
+  ///   <h1>"Foo"</h1>
+  /// };
+  ///
+  /// let equivalent = Header::builder().text("Foo").build();
+  ///
+  /// assert_eq!(xml, equivalent);
+  /// ```
+  pub fn header_block() -> blocks::header::build::HeaderBuilderInit<'static> {
+    blocks::Header::builder()
+  }
+
+  /// Alias for [`header_block`]
+  pub fn h1() -> blocks::header::build::HeaderBuilderInit<'static> {
+    blocks::Header::builder()
+  }
+
+  /// # [`blocks::Block::Divider`] - `<divider_block />` or `<hr />`
+  ///
+  /// Build a [`blocks::Block::Divider`]
+  ///
+  /// # Attributes
+  /// None
+  ///
+  /// ## Example
+  /// ```
+  /// use slack_blocks::{blocks::Block, blox::*};
+  ///
+  /// let xml = blox! {
+  ///   <hr />
+  /// };
+  ///
+  /// let equivalent = Block::Divider;
+  ///
+  /// assert_eq!(xml, equivalent);
+  /// ```
+  pub fn divider_block() -> DividerBuilder {
+    DividerBuilder
+  }
+
+  /// Alias for [`divider_block`]
+  pub fn hr() -> DividerBuilder {
+    divider_block()
+  }
+
+  /// # [`blocks::Section`] - `<section_block>`
   ///
-  /// ## Children
-  /// Accepts at least one, and up to 10 text objects as children.
+  /// Build a [`blocks::Section`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`text`]     | [`text::Plain`], [`text::Mrkdwn`], or [`text::Text`]|❌*|❌|
+  /// |[`field`]    | [`text::Plain`], [`text::Mrkdwn`], or [`text::Text`]|❌*|✅|
+  /// |[`fields`]   | [`IntoIterator`] over [`text::Text`]                |❌*|❌|
+  /// |[`accessory`]| [`elems::BlockElement`]                             |✅ |❌|
+  /// |[`block_id`] | [`String`] or [`&str`]                              |✅ |❌|
+  ///
+  /// &#42; `text`, `field(s)`, or both are required.
+  ///
+  /// [`text`]: blocks::section::build::SectionBuilder::text()
+  /// [`field`]: blocks::section::build::SectionBuilder::field()
+  /// [`fields`]: blocks::section::build::SectionBuilder::fields()
+  /// [`accessory`]: blocks::section::build::SectionBuilder::accessory()
+  /// [`block_id`]: blocks::section::build::SectionBuilder::block_id()
   ///
   /// ## Example
   /// ```
   /// use slack_blocks::{blocks::Section, blox::*, text};
   ///
+  /// let section_text = blox! { <text kind=plain>"Foo"</text> };
+  ///
   /// let xml = blox! {
-  ///   <section_block text=blox!{<text kind=plain>"Foo"</text>} />
+  ///   <section_block text=section_text>
+  ///     <text kind=mrkdwn>"Bar"</text>
+  ///   </section_block>
   /// };
   ///
-  /// let equivalent = Section::builder().text(text::Plain::from("Foo")).build();
+  /// let equivalent = Section::builder().text(text::Plain::from("Foo"))
+  ///                                    .field(text::Mrkdwn::from("Bar"))
+  ///                                    .build();
   ///
   /// assert_eq!(xml, equivalent);
   /// ```
@@ -88,12 +265,19 @@ mod blox_blocks {
     blocks::Section::builder()
   }
 
-  /// # Build an input block
+  /// # [`blocks::Input`] - `<input_block>`
   ///
-  /// ## Children
-  /// Input requires a single child of a supported block element.
+  /// Build a [`blocks::Input`]
   ///
-  /// For the list of supported elements, see `slack_blocks::blocks::input::SupportedElement`.
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`label`](blocks::input::build::InputBuilder::label())|[`text::Plain`], [`text::Mrkdwn`], or [`text::Text`] ([`<text>`](super::text()))|❌|❌|
+  /// |[`element`](blocks::input::build::InputBuilder::element())|`impl Into<`[`blocks::input::SupportedElement`]`>`|❌|✅|
+  /// |[`block_id`](blocks::input::build::InputBuilder::block_id())|[`String`] or [`&str`]|✅|❌|
+  /// |[`hint`](blocks::input::build::InputBuilder::hint())|[`text::Plain`] ([`<text>`](super::text())), [`String`], or [`&str`]|✅|❌|
+  /// |[`dispatch_actions`](blocks::input::build::InputBuilder::dispatch_actions())|[`bool`]|✅|❌|
+  /// |[`optional`](blocks::input::build::InputBuilder::optional())|[`bool`]|✅|❌|
   ///
   /// ## Example
   /// ```
@@ -116,10 +300,15 @@ mod blox_blocks {
     blocks::Input::builder()
   }
 
-  /// # Build a context block
+  /// # [`blocks::Context`] - `<context_block>`
+  ///
+  /// Build a [`blocks::Context`]
   ///
-  /// ## Children
-  /// Allows at least one, up to 10 text or img elements.
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`element`](blocks::context::build::ContextBuilder::element())|[`text::Text`] ([`<text>`](super::text())) or [`elems::Image`] ([`<img>`](super::img()))|❌|✅|
+  /// |[`block_id`](blocks::context::build::ContextBuilder::block_id())|[`String`] or [`&str`]|✅|❌|
   ///
   /// ## Example
   /// ```
@@ -148,10 +337,15 @@ mod blox_blocks {
     blocks::Context::builder()
   }
 
-  /// # Build a file block
+  /// # [`blocks::File`] - `<file_block>`
   ///
-  /// ## Children
-  /// None
+  /// Build a [`blocks::File`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`external_id`](blocks::file::build::FileBuilder::external_id())|[`String`] or [`&str`]|❌|✅|
+  /// |[`block_id`](blocks::file::build::FileBuilder::block_id())|[`String`] or [`&str`]|✅|❌|
   ///
   /// ## Example
   /// ```
@@ -169,10 +363,16 @@ mod blox_blocks {
     blocks::File::builder()
   }
 
-  /// # Build an image block
+  /// # [`blocks::Image`] - `<img_block>`
+  ///
+  /// Build a [`blocks::Image`]
   ///
-  /// ## Children
-  /// Allows at least one, up to 10 text or img elements.
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`src`](blocks::image::build::ImageBuilder::src())|[`String`] or [`&str`]|❌|❌|
+  /// |[`alt`](blocks::image::build::ImageBuilder::alt())|[`String`] or [`&str`]|❌|❌|
+  /// |[`block_id`](blocks::file::build::FileBuilder::block_id())|[`String`] or [`&str`]|✅|❌|
   ///
   /// ## Example
   /// ```
@@ -196,10 +396,30 @@ mod blox_blocks {
 mod blox_elems {
   use super::*;
 
-  /// # Build an text input element
+  /// # [`elems::TextInput`] - `<text_input>`
   ///
-  /// ## Children
-  /// None.
+  /// Build a [`elems::TextInput`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`action_id`]      | [`String`] or [`&str`]                      |❌|❌|
+  /// |[`action_trigger`] | [`elems::text_input::ActionTrigger`]        |✅|❌|
+  /// |[`placeholder`]    | [`text::Plain`] ([`<text>`](super::text())), [`String`] or [`&str`]     |✅|❌|
+  /// |[`initial_value`]  | [`String`] or [`&str`]                      |✅|❌|
+  /// |[`length`]         | impl [`std::ops::RangeBounds`] over [`u32`] |✅|❌|
+  /// |[`min_length`]     | [`u32`]                                     |✅|❌|
+  /// |[`max_length`]     | [`u32`]                                     |✅|❌|
+  /// |[`multiline`]      | [`bool`]                                    |✅|❌|
+  ///
+  /// [`action_id`]:      elems::text_input::build::TextInputBuilder::action_id()
+  /// [`action_trigger`]: elems::text_input::build::TextInputBuilder::action_trigger()
+  /// [`placeholder`]:    elems::text_input::build::TextInputBuilder::placeholder()
+  /// [`initial_value`]:  elems::text_input::build::TextInputBuilder::initial_value()
+  /// [`length`]:         elems::text_input::build::TextInputBuilder::length()
+  /// [`min_length`]:     elems::text_input::build::TextInputBuilder::min_length()
+  /// [`max_length`]:     elems::text_input::build::TextInputBuilder::max_length()
+  /// [`multiline`]:      elems::text_input::build::TextInputBuilder::multiline()
   ///
   /// ## Example
   /// ```
@@ -228,10 +448,15 @@ mod blox_elems {
     elems::TextInput::builder()
   }
 
-  /// # Build an image element
+  /// # [`elems::Image`] - `<img />`
   ///
-  /// ## Children
-  /// None.
+  /// Build a [`elems::Image`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`src`](elems::image::build::ImageBuilder::src()) | [`String`] or [`&str`] |❌|❌|
+  /// |[`alt`](elems::image::build::ImageBuilder::alt()) | [`String`] or [`&str`] |❌|❌|
   ///
   /// ## Example
   /// ```
@@ -251,21 +476,39 @@ mod blox_elems {
     elems::Image::builder()
   }
 
-  /// # Build a button
+  /// # [`elems::Button`] - `<button>`
+  ///
+  /// Build a [`elems::Button`]
   ///
-  /// ## Children
-  /// The text to display in the button
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`action_id`] | [`String`] or [`&str`]                                              |❌|❌|
+  /// |[`text`]      | [`text::Plain`] ([`<text>`](super::text())), [`String`] or [`&str`] |❌|✅|
+  /// |[`url`]       | [`String`] or [`&str`]                                              |✅|❌|
+  /// |[`value`]     | [`String`] or [`&str`]                                              |✅|❌|
+  /// |[`style`]     | [`elems::button::Style`] ([`btn_primary`] or [`btn_danger`])        |✅|❌|
+  /// |[`confirm`]   | [`compose::Confirm`] ([`<confirm>`](super::confirm()))              |✅|❌|
+  ///
+  /// [`action_id`]: elems::button::build::ButtonBuilder::action_id()
+  /// [`text`]: elems::button::build::ButtonBuilder::text()
+  /// [`url`]: elems::button::build::ButtonBuilder::url()
+  /// [`value`]: elems::button::build::ButtonBuilder::value()
+  /// [`style`]: elems::button::build::ButtonBuilder::style()
+  /// [`confirm`]: elems::button::build::ButtonBuilder::confirm()
   ///
   /// ## Example
   /// ```
-  /// use slack_blocks::{blox::*, elems::Button};
+  /// use slack_blocks::{blox::*,
+  ///                    elems::button::{Button, Style}};
   ///
   /// let xml: Button = blox! {
-  ///   <button action_id="click_me">"Click me!"</button>
+  ///   <button action_id="dangerous" style=btn_danger>"DANGER!"</button>
   /// };
   ///
-  /// let equiv = Button::builder().action_id("click_me")
-  ///                              .text("Click me!")
+  /// let equiv = Button::builder().action_id("dangerous")
+  ///                              .text("DANGER!")
+  ///                              .style(Style::Danger)
   ///                              .build();
   ///
   /// assert_eq!(xml, equiv)
@@ -274,10 +517,26 @@ mod blox_elems {
     elems::Button::builder()
   }
 
-  /// # Build a checkbox group
+  /// # [`elems::Checkboxes`] - `<checkboxes>`
+  ///
+  /// Build a [`elems::Checkboxes`]
   ///
-  /// ## Children
-  /// Options to populate the checkbox group with. Min 1, max 10
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`action_id`]       | [`String`] or [`&str`]                                               |❌|❌|
+  /// |[`option`]          | [`compose::Opt`] ([`<option>`](super::option()))*                    |❌ _(or `options`)_|✅|
+  /// |[`options`]         | [`Vec`] of [`compose::Opt`]*                                         |❌ _(or `option`)_|❌|
+  /// |[`initial_options`] | [`Vec`] of [`compose::Opt`]* provided via [`option`] or [`options`]. |✅|❌|
+  /// |[`confirm`]         | [`compose::Confirm`] ([`<confirm>`](super::confirm()))               |✅|❌|
+  ///
+  /// [`action_id`]: elems::checkboxes::build::CheckboxesBuilder::action_id()
+  /// [`option`]: elems::checkboxes::build::CheckboxesBuilder::option()
+  /// [`options`]: elems::checkboxes::build::CheckboxesBuilder::options()
+  /// [`initial_options`]: elems::checkboxes::build::CheckboxesBuilder::initial_options()
+  /// [`confirm`]: elems::checkboxes::build::CheckboxesBuilder::confirm()
+  ///
+  /// &#42; Options cannot have URL set, option text can be mrkdwn or plain.
   ///
   /// ## Example
   /// ```
@@ -318,10 +577,22 @@ mod blox_elems {
     elems::Checkboxes::builder()
   }
 
-  /// # Build a date picker
+  /// # [`elems::DatePicker`] - `<date_picker>`
   ///
-  /// ## Children
-  /// None
+  /// Build a [`elems::DatePicker`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`action_id`]    | [`String`] or [`&str`]                                 |❌|❌|
+  /// |[`placeholder`]  | [`String`] or [`&str`]                                 |✅|❌|
+  /// |[`initial_date`] | ([`u8`] _day_, [`u8`] _month_, [`u16`] _year_)         |✅|❌|
+  /// |[`confirm`]      | [`compose::Confirm`] ([`<confirm>`](super::confirm())) |✅|❌|
+  ///
+  /// [`action_id`]: elems::date_picker::build::DatePickerBuilder::action_id()
+  /// [`placeholder`]: elems::date_picker::build::DatePickerBuilder::placeholder()
+  /// [`initial_date`]: elems::date_picker::build::DatePickerBuilder::initial_date()
+  /// [`confirm`]: elems::date_picker::build::DatePickerBuilder::confirm()
   ///
   /// ## Example
   /// ```
@@ -344,10 +615,24 @@ mod blox_elems {
     elems::DatePicker::builder()
   }
 
-  /// # Build an overflow menu
+  /// # [`elems::Overflow`] - `<overflow>`
+  ///
+  /// Build a [`elems::Overflow`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`action_id`] | [`String`] or [`&str`]                                 |❌|❌|
+  /// |[`option`]    | [`compose::Opt`] ([`<option>`](super::option()))*      |❌ _(or options)_|✅|
+  /// |[`options`]   | [`Vec`] of [`compose::Opt`]*                           |❌ _(or option)_|❌|
+  /// |[`confirm`]   | [`compose::Confirm`] ([`<confirm>`](super::confirm())) |✅|❌|
+  ///
+  /// [`action_id`]: elems::overflow::build::OverflowBuilder::action_id()
+  /// [`option`]: elems::overflow::build::OverflowBuilder::option()
+  /// [`options`]: elems::overflow::build::OverflowBuilder::options()
+  /// [`confirm`]: elems::overflow::build::OverflowBuilder::confirm()
   ///
-  /// ## Children
-  /// Options contained in the overflow menu. Min 2, max 5.
+  /// &#42; Options **can** have URL set, option text must be plain.
   ///
   /// ## Example
   /// ```
@@ -376,10 +661,26 @@ mod blox_elems {
     elems::Overflow::builder()
   }
 
-  /// # Build a radio button group
+  /// # [`elems::Radio`] - `<radio_buttons>`
   ///
-  /// ## Children
-  /// Options contained in the radio button group
+  /// Build a [`elems::Radio`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`action_id`]      | [`String`] or [`&str`]                                 |❌|❌|
+  /// |[`option`]         | [`compose::Opt`] ([`<option>`](super::option()))*      |❌ _(or options)_|✅|
+  /// |[`options`]        | [`Vec`] of [`compose::Opt`]*                           |❌ _(or option)_|❌|
+  /// |[`initial_option`] | [`compose::Opt`]*                                      |✅|❌|
+  /// |[`confirm`]        | [`compose::Confirm`] ([`<confirm>`](super::confirm())) |✅|❌|
+  ///
+  /// [`action_id`]: elems::radio::build::RadioBuilder::action_id()
+  /// [`option`]: elems::radio::build::RadioBuilder::option()
+  /// [`options`]: elems::radio::build::RadioBuilder::options()
+  /// [`initial_option`]: elems::radio::build::RadioBuilder::initial_option()
+  /// [`confirm`]: elems::radio::build::RadioBuilder::confirm()
+  ///
+  /// &#42; Options **cannot** have URL set, option text can be mrkdwn or plain.
   ///
   /// ## Example
   /// ```
@@ -395,21 +696,25 @@ mod blox_elems {
   ///   </input_block>
   /// };
   ///
-  /// let radio = Radio::builder().action_id("cheese_picker")
-  ///                             .option(Opt::builder().value("feta")
-  ///                                                   .text_plain("Feta")
-  ///                                                   .build())
-  ///                             .option(Opt::builder().value("gouda")
-  ///                                                   .text_plain("Gouda")
-  ///                                                   .build())
-  ///                             .option(Opt::builder().value("cheddar")
-  ///                                                   .text_plain("Cheddar")
-  ///                                                   .build())
-  ///                             .build();
+  /// let equiv = {
+  ///   let feta = Opt::builder().value("feta").text_plain("Feta").build();
   ///
-  /// let equiv = Input::builder().label("Pick your favorite cheese!")
-  ///                             .element(radio)
-  ///                             .build();
+  ///   let gouda = Opt::builder().value("gouda").text_plain("Gouda").build();
+  ///
+  ///   let cheddar = Opt::builder().value("cheddar")
+  ///                               .text_plain("Cheddar")
+  ///                               .build();
+  ///
+  ///   let radio = Radio::builder().action_id("cheese_picker")
+  ///                               .option(feta)
+  ///                               .option(gouda)
+  ///                               .option(cheddar)
+  ///                               .build();
+  ///
+  ///   Input::builder().label("Pick your favorite cheese!")
+  ///                   .element(radio)
+  ///                   .build()
+  /// };
   ///
   /// assert_eq!(xml, equiv)
   /// ```
@@ -417,23 +722,121 @@ mod blox_elems {
     elems::Radio::builder()
   }
 
-  /// # Build a select menu
-  ///
-  /// # Attributes
-  /// - `kind` (Optional): `single` or `multi` from `slack_blocks::blox`. Default is `single`.
-  /// - `choose_from` (Required): `users`, `public_channels`, `static_`, `external`, `conversations` from `slack_blocks::blox`
-  ///
-  /// # Children
-  /// For `static_`, 1-100 `<option>` children are allowed.
+  /// # [`elems::select`] - `<select>`
   ///
-  /// For all others, none are allowed.
+  /// Build a [`elems::select`].
   ///
-  /// # Errors you may encounter
-  ///  - `Into<MyOpt> is not implemented for ...`: Make sure the `option` or `option_group` passed has the right `kind` of text for the select you're using.
-  ///  - `AppendOptOrOptGroup<MyOpt> is not implemented for ...`: Make sure the `option` or `option_group` has no `url` and contains **plain** text.
-  ///  - `Method `build` not found for...`: Make sure you've called all required methods. If you dig into the error message, you'll see `RequiredMethodNotCalled<method::foo>`, meaning you need to call `foo`.
+  /// # Attributes
   ///
-  /// # Example - Select many Users
+  /// This element behaves like a flow chart, allowing you to construct all
+  /// Single and Multi-selects with a single XML element.
+  ///
+  /// Use the `kind` attribute to distinguish between
+  /// single- and multi-selects.
+  ///
+  /// Use the `choose_from` attribute to distinguish between
+  /// the many sources of options for the select menu.
+  ///
+  /// ## Common
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`kind`]        | [`single`] (default) or [`multi`]                                            |✅|❌|
+  /// |[`choose_from`] | [`users`], [`public_channels`], [`static_`], [`external`], [`conversations`] |❌|❌|
+  /// |`action_id`     | [`String`] or [`&str`]                                                       |❌|❌|
+  /// |`placeholder`   | [`String`] or [`&str`]                                                       |✅|❌|
+  /// |`confirm`       | [`compose::Confirm`] ([`<confirm>`](super::confirm()))                       |✅|❌|
+  /// |**when kind=multi**<br/>`max_selected_items` | [`u32`] |✅|❌|
+  ///
+  /// [`kind`]: elems::select::build::SelectBuilder::kind()
+  /// [`choose_from`]: elems::select::build::SelectBuilder::choose_from()
+  ///
+  /// ## **When `choose_from=users`**
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |**when kind=single**<br/>[`initial_user`]| [`String`] or [`&str`] |✅|❌|
+  /// |**when kind=multi**<br/>[`initial_users`]| impl [`IntoIterator`] over [`String`] or [`&str`] |✅|❌|
+  ///
+  /// [`initial_user`]: elems::select::user::build::UserBuilder::initial_user()
+  /// [`initial_users`]: elems::select::user::build::UserBuilder::initial_users()
+  ///
+  /// ## **When `choose_from=public_channels`**
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |**when kind=single**<br/>[`initial_channel`]| [`String`] or [`&str`] |✅|❌|
+  /// |**when kind=multi**<br/>[`initial_channels`]| impl [`IntoIterator`] over [`String`] or [`&str`] |✅|❌|
+  ///
+  /// [`initial_channel`]: elems::select::public_channel::build::PublicChannelBuilder::initial_channel()
+  /// [`initial_channels`]: elems::select::public_channel::build::PublicChannelBuilder::initial_channels()
+  ///
+  /// ## **When `choose_from=external`**
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`min_query_length`] | [`u64`] |✅|❌|
+  /// |**when kind=single**<br/>[`initial_option`]| [`compose::Opt`]* |✅|❌|
+  /// |**when kind=single**<br/>[`initial_option_group`]| [`compose::OptGroup`]* |✅|❌|
+  /// |**when kind=multi**<br/>[`initial_options`]| impl [`IntoIterator`] over [`compose::Opt`]s*  |✅|❌|
+  /// |**when kind=multi**<br/>[`initial_option_groups`]| impl [`IntoIterator`] over [`compose::OptGroup`]s*  |✅|❌|
+  ///
+  /// &#42; Options **cannot** have URL set, option text must be plain.
+  ///
+  /// [`initial_option`]: elems::select::external::build::ExternalBuilder::initial_option()
+  /// [`initial_option_group`]: elems::select::external::build::ExternalBuilder::initial_option_group()
+  /// [`initial_option_groups`]: elems::select::external::build::ExternalBuilder::initial_option_groups()
+  /// [`initial_options`]: elems::select::external::build::ExternalBuilder::initial_options()
+  /// [`min_query_length`]: elems::select::external::build::ExternalBuilder::min_query_length()
+  ///
+  /// ## **When `choose_from=conversations`**
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`filter`] | [`compose::ConversationFilter`] |✅|❌|
+  /// |[`initial_channel_current`] | [`bool`] |✅|❌|
+  /// |**when kind=single**<br/>[`initial_channel`]| [`String`] or [`&str`] |✅|❌|
+  /// |**when kind=multi**<br/>[`initial_channels`]| impl [`IntoIterator`] over [`String`]s or [`&str`]s |✅|❌|
+  ///
+  /// [`filter`]: elems::select::conversation::build::ConversationBuilder::filter()
+  /// [`initial_channel_current`]: elems::select::conversation::build::ConversationBuilder::initial_channel_current()
+  /// [`initial_channel`]: elems::select::conversation::build::ConversationBuilder::initial_channel()
+  /// [`initial_channels`]: elems::select::conversation::build::ConversationBuilder::initial_channels()
+  ///
+  /// ## **When `choose_from=static_`**
+  /// This is the most complex select menu.
+  ///
+  /// It allows you to define the options in your app
+  /// by using children or `options`/`option_groups`.
+  ///
+  /// Note that all children must **either** be `<option>`s or `<option_group>`s.
+  /// You cannot mix options and groups in the same static select menu.
+  ///
+  /// For single-selects that use options, you can pre-select one of them with `initial_option`.
+  ///
+  /// For multi-selects that use options, you can pre-select any number of them with `initial_options`.
+  ///
+  /// For single-selects that use option groups, you can pre-select one of them with `initial_option_group`.
+  ///
+  /// For multi-selects that use option groups, you can pre-select any number of them with `initial_option_groups`.
+  ///
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// | Child | [`compose::Opt`] ([`<option>`](super::option())) or [`compose::OptGroup`] ([`<option_group>`](super::option_group()))* |❌ _(or `options` or `option_groups`)_|✅|
+  /// |[`option_groups`] | [`Vec`] of [`compose::OptGroup`]*                                                                           |❌ _(or Child or `option_groups`)_|❌|
+  /// |[`options`]       | [`Vec`] of [`compose::Opt`]*                                                                                |❌ _(or Child or `options`)_ |❌|
+  /// |**when kind=single**<br/>**and select uses Opts**<br/>(not OptGroups)<br/>[`initial_option`]| [`compose::Opt`]* |✅|❌|
+  /// |**when kind=single**<br/>**and select uses OptGroup**<br/>(not Opts)<br/>[`initial_option_group`]| [`compose::OptGroup`]* |✅|❌|
+  /// |**when kind=multi**<br/>**and select uses Opt**<br/>(not OptGroups)<br/>[`initial_options`]| impl [`IntoIterator`] over [`compose::Opt`]* |✅|❌|
+  /// |**when kind=multi**<br/>**and select uses OptGroup**<br/>(not Opts)<br/>[`initial_option_groups`]| impl [`IntoIterator`] over [`compose::OptGroup`]* |✅|❌|
+  ///
+  /// &#42; All children must either be options or option groups. Options **cannot** have URL set, option text must be plain.
+  ///
+  /// [`initial_option`]: elems::select::static_::build::StaticBuilder::initial_option()
+  /// [`initial_options`]: elems::select::static_::build::StaticBuilder::initial_options()
+  /// [`initial_option_group`]: elems::select::static_::build::StaticBuilder::initial_option_group()
+  /// [`initial_option_groups`]: elems::select::static_::build::StaticBuilder::initial_option_groups()
+  /// [`options`]: elems::select::static_::build::StaticBuilder::options()
+  /// [`option_groups`]: elems::select::static_::build::StaticBuilder::option_groups()
+  ///
+  /// # Examples
+  ///
+  /// ## `choose_from=users`
   /// ```
   /// use slack_blocks::elems::select;
   /// use slack_blocks::blox::*;
@@ -447,7 +850,7 @@ mod blox_elems {
   /// assert_eq!(xml, equiv)
   /// ```
   ///
-  /// # Example - Select an option from a list defined by your app
+  /// ## `choose_from=static_`
   /// ```
   /// use slack_blocks::{elems::select, compose::Opt, blox::*};
   ///
@@ -478,12 +881,22 @@ mod blox_elems {
 mod blox_compose {
   use super::*;
 
-  /// # Text
+  /// # [`compose::text`] - `<text>`
+  ///
+  /// Build a [`compose::text`]
   ///
-  /// ## Children
-  /// Accepts a `String`, `&str` or anything else that implements
-  /// `AsRef<str>` as a child, representing the text that will be
-  /// rendered in Slack.
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`kind`]                              | [`mrkdwn`] or [`plain`] |❌|❌|
+  /// |[`text`]                              | [`&str`] or [`String`]  |❌|✅|
+  /// |**When kind=plain**<br/>[`emoji`]     | [`bool`]                |✅|❌|
+  /// |**When kind=mrkdwn**<br/>[`verbatim`] | [`bool`]                |✅|❌|
+  ///
+  /// [`kind`]: compose::text::build::TextBuilder::kind()
+  /// [`text`]: compose::text::build::TextBuilder::text()
+  /// [`emoji`]: compose::text::build::TextBuilder::emoji()
+  /// [`verbatim`]: compose::text::build::TextBuilder::verbatim()
   ///
   /// ## Example
   /// ```
@@ -501,13 +914,22 @@ mod blox_compose {
     text::Text::builder()
   }
 
-  /// # Option
+  /// # [`compose::opt`] - `<option>`
   ///
-  /// ## Children
-  /// The text to be displayed to the user.
+  /// Build a [`compose::opt`]
   ///
-  /// Note that text can't be provided as a child if you're setting `url`
-  /// within an overflow menu - you need to set the text via a `text_plain` attribute.
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`value`] | [`&str`] or [`String`]  |❌|❌|
+  /// |[`text`]  | [`text::Plain`] or [`text::Mrkdwn`] ([`<text>`](super::text())) |❌|✅|
+  /// |[`desc`]  | [`&str`], [`String`], or [`text::Plain`] |✅|❌|
+  /// |[`url`]   | [`&str`] or [`String`]  |✅|❌|
+  ///
+  /// [`value`]: compose::opt::build::OptBuilder::value()
+  /// [`text`]: compose::opt::build::OptBuilder::text()
+  /// [`desc`]: compose::opt::build::OptBuilder::desc()
+  /// [`url`]: compose::opt::build::OptBuilder::url()
   ///
   /// ## Example
   /// ```
@@ -527,10 +949,24 @@ mod blox_compose {
     compose::Opt::builder()
   }
 
-  /// # Option Group
+  /// # [`compose::opt_group`] - `<option_group>`
+  ///
+  /// Build a [`compose::opt_group`]
   ///
-  /// ## Children
-  /// Up to 100 option objects of the same type. Note that `syn-rsx` (and `mox` by extension)
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`label`] | [`&str`], [`String`], or [`text::Plain`]      |❌|❌|
+  /// |[`option`] | [`compose::Opt`]                             |❌ _(or options)_|✅|
+  /// |[`options`] | impl [`IntoIterator`] over [`compose::Opt`] |❌ _(or option)_|❌|
+  ///
+  /// [`label`]: compose::opt_group::build::OptGroupBuilder::label()
+  /// [`option`]: compose::opt_group::build::OptGroupBuilder::option()
+  /// [`options`]: compose::opt_group::build::OptGroupBuilder::options()
+  ///
+  /// Supports up to 100 option objects of the same type.
+  ///
+  /// Note that `syn-rsx` (and `mox` by extension)
   /// do not support using iterables as children.
   ///
   /// This means that if you have a `Vec<Opt>`,
@@ -599,10 +1035,26 @@ mod blox_compose {
     compose::OptGroup::builder()
   }
 
-  /// # Confirm
+  /// # [`compose::Confirm`] - `<confirm>`
   ///
-  /// ## Children
-  /// No children.
+  /// Build a [`compose::Confirm`]
+  ///
+  /// # Attributes
+  /// |Attribute|Type|Optional|Available as child|
+  /// |-|-|-|-|
+  /// |[`title`] | [`&str`], [`String`], or [`text::Plain`]   |❌|❌|
+  /// |[`text`], [`text_plain`], or [`text_md`]|`text` wants [`text::Plain`] or [`text::Mrkdwn`]. `text_md` & `text_plain` want [`&str`] or [`String`]. |❌|❌|
+  /// |[`confirm`] | [`&str`], [`String`], or [`text::Plain`] |❌|❌|
+  /// |[`deny`] | [`&str`], [`String`], or [`text::Plain`]    |❌|❌|
+  /// |[`style`] | [`compose::confirm::ConfirmStyle`]    |✅|❌|
+  ///
+  /// [`title`]: compose::confirm::build::ConfirmBuilder::title()
+  /// [`text`]: compose::confirm::build::ConfirmBuilder::text()
+  /// [`text_plain`]: compose::confirm::build::ConfirmBuilder::text_plain()
+  /// [`text_md`]: compose::confirm::build::ConfirmBuilder::text_md()
+  /// [`confirm`]: compose::confirm::build::ConfirmBuilder::confirm()
+  /// [`deny`]: compose::confirm::build::ConfirmBuilder::deny()
+  /// [`style`]: compose::confirm::build::ConfirmBuilder::style()
   ///
   /// ## Example
   /// ```
@@ -610,7 +1062,7 @@ mod blox_compose {
   ///
   /// let xml = blox! {
   ///   <confirm title="Title"
-  ///            text=blox!{<text kind=plain>"Body"</text>}
+  ///            text="Body".plaintext()
   ///            confirm="Yes"
   ///            deny="No"
   ///   />
diff --git a/src/compose/confirm.rs b/src/compose/confirm.rs
index b58129b..2bf1266 100644
--- a/src/compose/confirm.rs
+++ b/src/compose/confirm.rs
@@ -132,8 +132,10 @@ pub mod build {
   ///
   /// # Required Methods
   /// `ConfirmBuilder::build()` is only available if these methods have been called:
+  ///  - `title`
   ///  - `text`
-  ///  - `plain` or `mrkdwn`
+  ///  - `confirm`
+  ///  - `deny`
   ///
   /// ```
   /// use slack_blocks::compose::Confirm;
diff --git a/src/compose/mod.rs b/src/compose/mod.rs
index bfff7eb..095dec7 100644
--- a/src/compose/mod.rs
+++ b/src/compose/mod.rs
@@ -11,15 +11,10 @@
 
 use serde::{Deserialize, Serialize};
 
-#[doc(inline)]
 pub mod confirm;
-#[doc(inline)]
 pub mod conversation_filter;
-#[doc(inline)]
 pub mod opt;
-#[doc(inline)]
 pub mod opt_group;
-#[doc(inline)]
 pub mod text;
 
 #[doc(inline)]
diff --git a/src/compose/text/mod.rs b/src/compose/text/mod.rs
index 3621473..e13dbe6 100644
--- a/src/compose/text/mod.rs
+++ b/src/compose/text/mod.rs
@@ -11,9 +11,7 @@ use serde::{Deserialize, Serialize};
 
 use crate::convert;
 
-#[doc(inline)]
 pub mod mrkdwn;
-#[doc(inline)]
 pub mod plain;
 
 #[doc(inline)]
diff --git a/src/compose/text/mrkdwn.rs b/src/compose/text/mrkdwn.rs
index 7040377..73d1fe8 100644
--- a/src/compose/text/mrkdwn.rs
+++ b/src/compose/text/mrkdwn.rs
@@ -46,7 +46,7 @@ use serde::{Deserialize, Serialize};
 /// |`` `some code!` ``| `some code!`        |
 /// |`` ```multiline code\n2 lines!``` `` | <code>multiline code<br> 2 lines!</code> |
 /// |` - li \n - li `  | <ul><li>li</li><li>li</li></ul> |
-/// |<code>&lt;http://www.foo.com&#124;link name&gt;</code>| [link name](http://www.foo.com) |
+/// |<code>&lt;<http://www.foo.com>&#124;link name&gt;</code>| [link name](http://www.foo.com) |
 /// |`:joy:` (list from [iamcal/emoji-data 🔗](https://github.com/iamcal/emoji-data)) | 😂 |
 /// | link to #channel: `<#Cxxxxxx>` | [#channel](https://work.slack.com/some-public-channel) |
 /// | link to @user: `<@Uxxxxxx>` | [@user](https://work.slack.com/some-user) |
diff --git a/src/elems/checkboxes.rs b/src/elems/checkboxes.rs
index 4bcc1e3..5951e37 100644
--- a/src/elems/checkboxes.rs
+++ b/src/elems/checkboxes.rs
@@ -28,12 +28,12 @@ type MyOpt<'a> = Opt<'a, AnyText, NoUrl>;
 
 #[cfg(feature = "validation")]
 fn validate_options<'a>(o: &Cow<'a, [MyOpt<'a>]>) -> ValidatorResult {
-  below_len("Checkboxes.options", 10, o.as_ref())
+  below_len("options", 10, o.as_ref())
 }
 
 #[cfg(feature = "validation")]
 fn validate_initial_options<'a>(o: &Cow<'a, [MyOpt<'a>]>) -> ValidatorResult {
-  below_len("Checkboxes.initial_options", 10, o.as_ref())
+  below_len("initial_options", 10, o.as_ref())
 }
 
 /// # Checkbox Group
@@ -184,7 +184,7 @@ pub mod build {
   /// let boxes =
   ///   Checkboxes::builder().action_id("state_picker")
   ///                        .options(states)
-  ///                        .initial_options(vec![state_opt(usa::arizona()).into()])
+  ///                        .initial_options(vec![state_opt(usa::arizona())])
   ///                        .build();
   ///
   /// let block: Block = Actions::builder().element(boxes).build().into();
@@ -291,8 +291,13 @@ pub mod build {
     /// These options will be selected when the checkbox group initially loads.
     ///
     /// [option objects 🔗]: https://api.slack.com/reference/messaging/composition-objects#option
-    pub fn initial_options(mut self, options: Vec<MyOpt<'a>>) -> Self {
-      self.initial_options = Some(options);
+    pub fn initial_options<T: Into<text::Text>>(mut self,
+                                                options: Vec<Opt<'a,
+                                                        T,
+                                                        NoUrl>>)
+                                                -> Self {
+      self.initial_options =
+        Some(options.into_iter().map(|o| o.into()).collect());
       self
     }
 
diff --git a/src/elems/mod.rs b/src/elems/mod.rs
index 43daedd..1f0b3f9 100644
--- a/src/elems/mod.rs
+++ b/src/elems/mod.rs
@@ -19,21 +19,13 @@ use crate::convert;
 #[cfg(feature = "validation")]
 use crate::val_helpr::ValidationResult;
 
-#[doc(inline)]
 pub mod button;
-#[doc(inline)]
 pub mod checkboxes;
-#[doc(inline)]
 pub mod date_picker;
-#[doc(inline)]
 pub mod image;
-#[doc(inline)]
 pub mod overflow;
-#[doc(inline)]
 pub mod radio;
-#[doc(inline)]
 pub mod select;
-#[doc(inline)]
 pub mod text_input;
 
 #[doc(inline)]
diff --git a/src/elems/radio.rs b/src/elems/radio.rs
index 3fd5f31..6c781c4 100644
--- a/src/elems/radio.rs
+++ b/src/elems/radio.rs
@@ -189,6 +189,7 @@ pub mod build {
     ///
     /// Should be unique among all other `action_id`s in the containing block.
     /// Maximum length for this field is 255 characters.
+    ///
     /// [identify the source of the action 🔗]: https://api.slack.com/interactivity/handling#payloads
     pub fn action_id<S>(mut self,
                         action_id: S)
@@ -204,6 +205,7 @@ pub mod build {
     /// An array of [option objects 🔗].
     ///
     /// A maximum of 10 options are allowed.
+    ///
     /// [option objects 🔗]: https://api.slack.com/reference/block-kit/composition-objects#option
     pub fn options<I, T2: Into<text::Text>>(
       self,
diff --git a/src/elems/select/mod.rs b/src/elems/select/mod.rs
index 9c9de1a..9968ca6 100644
--- a/src/elems/select/mod.rs
+++ b/src/elems/select/mod.rs
@@ -12,18 +12,12 @@
 //! [Select Menu Element 🔗]: https://api.slack.com/reference/block-kit/block-elements#select
 //! [guide to enabling interactivity 🔗]: https://api.slack.com/interactivity/handling
 
-#[doc(inline)]
 pub mod multi;
 
-#[doc(inline)]
 pub mod conversation;
-#[doc(inline)]
 pub mod external;
-#[doc(inline)]
 pub mod public_channel;
-#[doc(inline)]
 pub mod static_;
-#[doc(inline)]
 pub mod user;
 
 #[doc(inline)]
diff --git a/src/elems/select/multi/mod.rs b/src/elems/select/multi/mod.rs
index a69d452..71563dd 100644
--- a/src/elems/select/multi/mod.rs
+++ b/src/elems/select/multi/mod.rs
@@ -11,15 +11,10 @@
 //! [select menus 🔗]: https://api.slack.com/reference/block-kit/block-elements#select
 //! [guide to enabling interactivity 🔗]: https://api.slack.com/interactivity/handling
 
-#[doc(inline)]
 pub mod conversation;
-#[doc(inline)]
 pub mod external;
-#[doc(inline)]
 pub mod public_channel;
-#[doc(inline)]
 pub mod static_;
-#[doc(inline)]
 pub mod user;
 
 #[doc(inline)]
diff --git a/src/elems/select/multi/user.rs b/src/elems/select/multi/user.rs
index a661103..39f7c44 100644
--- a/src/elems/select/multi/user.rs
+++ b/src/elems/select/multi/user.rs
@@ -36,7 +36,7 @@ pub struct User<'a> {
   pub(in crate::elems::select) confirm: Option<Confirm>,
 
   #[serde(skip_serializing_if = "Option::is_none")]
-  pub(in crate::elems::select) initial_users: Option<Cow<'a, [String]>>,
+  pub(in crate::elems::select) initial_users: Option<Vec<Cow<'a, str>>>,
 
   #[cfg_attr(feature = "validation", validate(range(min = 1)))]
   #[serde(skip_serializing_if = "Option::is_none")]
diff --git a/src/elems/select/user.rs b/src/elems/select/user.rs
index c283294..ef5b81d 100644
--- a/src/elems/select/user.rs
+++ b/src/elems/select/user.rs
@@ -149,7 +149,7 @@ pub mod build {
     action_id: Option<Cow<'a, str>>,
     confirm: Option<Confirm>,
     initial_user: Option<Cow<'a, str>>,
-    initial_users: Option<Cow<'a, [String]>>,
+    initial_users: Option<Vec<Cow<'a, str>>>,
     max_selected_items: Option<u32>,
     state: PhantomData<(Multi, Placeholder, ActionId)>,
   }
@@ -256,10 +256,14 @@ pub mod build {
     /// Set `initial_users` (Optional)
     ///
     /// A collection of user IDs of any valid users to be pre-selected when the menu loads.
-    pub fn initial_users<S>(mut self, users: S) -> Self
-      where S: Into<Cow<'a, [String]>>
+    pub fn initial_users<S, I>(mut self, users: I) -> Self
+      where S: Into<Cow<'a, str>>,
+            I: IntoIterator<Item = S>
     {
-      self.initial_users = Some(users.into());
+      self.initial_users = Some(users.into_iter()
+                                     .map(|s| s.into())
+                                     .collect::<Vec<_>>()
+                                     .into());
       self.cast_state()
     }
 
diff --git a/src/lib.rs b/src/lib.rs
index dc1d22b..52cc02e 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -74,7 +74,7 @@
 
 #![doc(html_root_url = "https://docs.rs/slack-blocks/0.24.4")]
 #![cfg_attr(docsrs, feature(doc_cfg))]
-#![cfg_attr(docsrs, feature(intra_rustdoc_links))]
+// #![feature(doc_cfg)] // for local docs
 #![deny(missing_docs)]
 #![cfg_attr(not(test),
             forbid(missing_copy_implementations,
@@ -91,11 +91,8 @@ extern crate validator_derive;
 #[cfg_attr(docsrs, doc(cfg(feature = "blox")))]
 pub mod blox;
 
-#[doc(inline)]
 pub mod blocks;
-#[doc(inline)]
 pub mod compose;
-#[doc(inline)]
 pub mod elems;
 
 mod build;
diff --git a/tests/json/blocks/divider.rs b/tests/json/blocks/divider.rs
new file mode 100644
index 0000000..f0ff430
--- /dev/null
+++ b/tests/json/blocks/divider.rs
@@ -0,0 +1,14 @@
+use pretty_assertions::assert_eq;
+use serde_json::json;
+use slack_blocks::{blocks, blox::*};
+
+#[test]
+pub fn docs_ex_1() {
+  let block: blocks::Block = blox! {<hr />}.into();
+  let actual = serde_json::to_value(block).unwrap();
+  let expected = json!({
+    "type": "divider"
+  });
+
+  assert_eq!(actual, expected);
+}
diff --git a/tests/json/blocks/header.rs b/tests/json/blocks/header.rs
new file mode 100644
index 0000000..b47425c
--- /dev/null
+++ b/tests/json/blocks/header.rs
@@ -0,0 +1,42 @@
+use pretty_assertions::assert_eq;
+use serde_json::json;
+use slack_blocks::{blocks, blox::*};
+
+#[test]
+pub fn it_works() {
+  blox! {
+    <h1>"Foo"</h1>
+  };
+}
+
+#[test]
+pub fn docs_ex_1() {
+  let block: blocks::Block = blox! {<h1>"Budget Performance"</h1>}.into();
+  let actual = serde_json::to_value(block).unwrap();
+  let expected = json!({
+    "type": "header",
+    "text": {
+      "type": "plain_text",
+      "text": "Budget Performance"
+    }
+  });
+
+  assert_eq!(actual, expected);
+}
+
+#[test]
+pub fn all_attrs() {
+  let block: blocks::Block =
+    blox! {<h1 block_id="foo">"Budget Performance"</h1>}.into();
+  let actual = serde_json::to_value(block).unwrap();
+  let expected = json!({
+    "type": "header",
+    "block_id": "foo",
+    "text": {
+      "type": "plain_text",
+      "text": "Budget Performance"
+    }
+  });
+
+  assert_eq!(actual, expected);
+}
diff --git a/tests/json/blocks/mod.rs b/tests/json/blocks/mod.rs
index 2115fba..277612c 100644
--- a/tests/json/blocks/mod.rs
+++ b/tests/json/blocks/mod.rs
@@ -15,3 +15,9 @@ pub use file::*;
 
 pub mod image;
 pub use image::*;
+
+pub mod header;
+pub use header::*;
+
+pub mod divider;
+pub use divider::*;
diff --git a/tests/json/elems/checkboxes.rs b/tests/json/elems/checkboxes.rs
index aca8d11..dab4948 100644
--- a/tests/json/elems/checkboxes.rs
+++ b/tests/json/elems/checkboxes.rs
@@ -7,7 +7,7 @@ pub fn docs_ex_1() {
   let opt_1 = blox! {<option value="A1" text_plain="Checkbox 1" />};
   let block: elems::BlockElement =
     blox! {
-      <checkboxes action_id="this_is_an_action_id" initial_options=vec![opt_1.clone().into()]>
+      <checkboxes action_id="this_is_an_action_id" initial_options=vec![opt_1.clone()]>
         {opt_1}
         <option value="A2" text_plain="Checkbox 2" />
       </checkboxes>
@@ -56,7 +56,7 @@ pub fn all_attributes() {
   };
   let block: elems::BlockElement =
     blox! {
-      <checkboxes confirm action_id="this_is_an_action_id" initial_options=vec![opt_1.clone().into()]>
+      <checkboxes confirm action_id="this_is_an_action_id" initial_options=vec![opt_1.clone()]>
         {opt_1}
         <option value="A2" text_plain="Checkbox 2" />
       </checkboxes>