3 files changed, 32 insertions, 0 deletions
diff --git a/native/src/renderer.rs b/native/src/renderer.rs
index 3e19be33..7a68ada4 100644
--- a/native/src/renderer.rs
+++ b/native/src/renderer.rs
@@ -32,9 +32,21 @@ pub use windowed::{Target, Windowed};
 
 use crate::{layout, Element};
 
+/// A component that can take the state of a user interface and produce an
+/// output for its users.
 pub trait Renderer: Sized {
+    /// The type of output of the [`Renderer`].
+    ///
+    /// If you are implementing a graphical renderer, your output will most
+    /// likely be a tree of visual primitives.
+    ///
+    /// [`Renderer`]: trait.Renderer.html
     type Output;
 
+    /// Lays out the elements of a user interface.
+    ///
+    /// You should override this if you need to perform any operations before or
+    /// after layouting. For instance, trimming the measurements cache.
     fn layout<'a, Message>(
         &mut self,
         element: &Element<'a, Message, Self>,
diff --git a/native/src/renderer/null.rs b/native/src/renderer/null.rs
index 8933b09b..3334e6b6 100644
--- a/native/src/renderer/null.rs
+++ b/native/src/renderer/null.rs
@@ -4,6 +4,7 @@ use crate::{
     Rectangle, Renderer, Size, VerticalAlignment,
 };
 
+/// A renderer that does nothing.
 pub struct Null;
 
 impl Renderer for Null {
diff --git a/native/src/renderer/windowed.rs b/native/src/renderer/windowed.rs
index 6d0419d2..813a03f2 100644
--- a/native/src/renderer/windowed.rs
+++ b/native/src/renderer/windowed.rs
@@ -2,11 +2,21 @@ use crate::MouseCursor;
 
 use raw_window_handle::HasRawWindowHandle;
 
+/// A renderer that can target windows.
 pub trait Windowed: super::Renderer + Sized {
+    /// The type of target.
     type Target: Target<Renderer = Self>;
 
+    /// Creates a new [`Windowed`] renderer.
+    ///
+    /// [`Windowed`]: trait.Windowed.html
     fn new() -> Self;
 
+    /// Performs the drawing operations described in the output on the given
+    /// target.
+    ///
+    /// The overlay can be a bunch of debug text logs. It should be rendered on
+    /// top of the GUI on most scenarios.
     fn draw<T: AsRef<str>>(
         &mut self,
         output: &Self::Output,
@@ -15,9 +25,15 @@ pub trait Windowed: super::Renderer + Sized {
     ) -> MouseCursor;
 }
 
+/// A rendering target.
 pub trait Target {
+    /// The renderer of this target.
     type Renderer;
 
+    /// Creates a new rendering [`Target`] from the given window handle, width,
+    /// height and dpi factor.
+    ///
+    /// [`Target`]: trait.Target.html
     fn new<W: HasRawWindowHandle>(
         window: &W,
         width: u16,
@@ -26,6 +42,9 @@ pub trait Target {
         renderer: &Self::Renderer,
     ) -> Self;
 
+    /// Resizes the current [`Target`].
+    ///
+    /// [`Target`]: trait.Target.html
     fn resize(
         &mut self,
         width: u16,