diff --git a/docs/containers/arrays/array.md b/docs/containers/arrays/array.md
index 1b848dac..fcf8af32 100644
--- a/docs/containers/arrays/array.md
+++ b/docs/containers/arrays/array.md
@@ -39,7 +39,7 @@ Defines data as an array of 'int', of length '10', containing the supplied data.
 
 ```cpp
 template <typename T, typename... TValues>
-constexpr auto make_array(TValues&&... values)
+constexpr auto make_array(TValues&&... values) -> etl::array<T, sizeof...(TValues)>
 ```
 
 ### Example
diff --git a/docs/containers/lists/forward-list.md b/docs/containers/lists/forward-list.md
index 2be721e0..442d6b51 100644
--- a/docs/containers/lists/forward-list.md
+++ b/docs/containers/lists/forward-list.md
@@ -65,13 +65,15 @@ Defines data as an `forward_list` of int, of length 10, containing the supplied
 ## Make template
 **C++11 and above**  
 ```cpp
-template <typename T, typename... TValues>
-  constexpr auto make_forward_list(TValues&&... values)
+template <typename... T>
+constexpr auto make_forward_list(T&&... t) -> etl::forward_list<typename etl::common_type_t<T...>, sizeof...(T)>
 ```
 
+The element type is deduced as the common type of the arguments.
+
 ### Example
 ```cpp
-auto data = etl::make_forward_list<int>(0, 1, 2, 3, 4, 5, 6, 7, 8, 9);
+auto data = etl::make_forward_list(0, 1, 2, 3, 4, 5, 6, 7, 8, 9);
 ```
 
 ## Member types
diff --git a/docs/containers/maps/flat-map.md b/docs/containers/maps/flat-map.md
index dd1d1850..cc3ea886 100644
--- a/docs/containers/maps/flat-map.md
+++ b/docs/containers/maps/flat-map.md
@@ -40,13 +40,13 @@ template <typename TKey,
           typename TMapped, 
           typename TKeyCompare = etl::less<TKey>, 
           typename... TPairs>
-constexpr auto make_flat_map(TValues&&... values)
+constexpr auto make_flat_map(TPairs&&... pairs) -> etl::flat_map<TKey, TMapped, sizeof...(TPairs), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_flat_map<int, int>(etl::pair{0, 1}, etl::pair{2, 3}, 
-                                         etl::pair{4, 5}, etl::pair{6, 7});
+auto data = etl::make_flat_map<int, int>(etl::pair<int, int>{0, 1}, etl::pair<int, int>{2, 3},
+                                         etl::pair<int, int>{4, 5}, etl::pair<int, int>{6, 7});
 ```
 
 ## Member types
diff --git a/docs/containers/maps/flat-multimap.md b/docs/containers/maps/flat-multimap.md
index b6f6832d..58bda46b 100644
--- a/docs/containers/maps/flat-multimap.md
+++ b/docs/containers/maps/flat-multimap.md
@@ -33,20 +33,20 @@ etl::flat_multimap data{ etl::pair{0, 1}, etl::pair{2, 3}, etl::pair{4, 5}, etl:
 ```
 Defines data as an `flat_multimap` of `int`/`int` pairs, of length 4, containing the supplied data.
 
-## make_flat_map
+## make_flat_multimap
 C++11 and above
 ```cpp
 template <typename TKey, 
           typename TMapped, 
           typename TKeyCompare = etl::less<TKey>, 
           typename... TPairs>
-constexpr auto make_flat_map(TValues&&... values)
+constexpr auto make_flat_multimap(TPairs&&... pairs) -> etl::flat_multimap<TKey, TMapped, sizeof...(TPairs), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_flat_map<int, int>(etl::pair{0, 1}, etl::pair{2, 3}, 
-                                         etl::pair{4, 5}, etl::pair{6, 7});
+auto data = etl::make_flat_multimap<int, int>(etl::pair<int, int>{0, 1}, etl::pair<int, int>{2, 3},
+                                              etl::pair<int, int>{4, 5}, etl::pair<int, int>{6, 7});
 ```
 
 ## Member types
diff --git a/docs/containers/maps/map.md b/docs/containers/maps/map.md
index c2c26396..8b747fb8 100644
--- a/docs/containers/maps/map.md
+++ b/docs/containers/maps/map.md
@@ -38,13 +38,13 @@ template <typename TKey,
           typename TMapped, 
           typename TKeyCompare = etl::less<TKey>, 
           typename... TPairs>
-constexpr auto make_flat_map(TValues&&... values)
+constexpr auto make_map(TPairs&&... pairs) -> etl::map<TKey, TMapped, sizeof...(TPairs), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_map<int, int>(etl::pair{0, 1}, etl::pair{2, 3},
-                                    etl::pair{4, 5}, etl::pair{6, 7});
+auto data = etl::make_map<int, int>(etl::pair<int, int>{0, 1}, etl::pair<int, int>{2, 3},
+                                    etl::pair<int, int>{4, 5}, etl::pair<int, int>{6, 7});
 ```
 
 ## Member types
diff --git a/docs/containers/maps/multimap.md b/docs/containers/maps/multimap.md
index 09fda167..67c02108 100644
--- a/docs/containers/maps/multimap.md
+++ b/docs/containers/maps/multimap.md
@@ -38,13 +38,13 @@ template <typename TKey,
           typename TMapped, 
           typename TKeyCompare = etl::less<TKey>, 
           typename... TPairs>
-constexpr auto make_flat_map(TValues&&... values)
+constexpr auto make_multimap(TPairs&&... pairs) -> etl::multimap<TKey, TMapped, sizeof...(TPairs), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_multimap<int, int>(etl::pair{0, 1}, etl::pair{2, 3},
-                                    etl::pair{4, 5}, etl::pair{6, 7});
+auto data = etl::make_multimap<int, int>(etl::pair<int, int>{0, 1}, etl::pair<int, int>{2, 3},
+                                         etl::pair<int, int>{4, 5}, etl::pair<int, int>{6, 7});
 ```
 
 ## Member types
diff --git a/docs/containers/maps/reference-flat-map.md b/docs/containers/maps/reference-flat-map.md
index 57f7dda1..baa0a013 100644
--- a/docs/containers/maps/reference-flat-map.md
+++ b/docs/containers/maps/reference-flat-map.md
@@ -36,19 +36,32 @@ etl::reference_flat_map data{ etl::pair{0, 1}, etl::pair{2, 3}, etl::pair{4, 5},
 Defines data as an reference_flat_map of int, of length 4, containing the supplied data.
 
 ## Make template
-C++11 and above
-
+**C++11 and above**
 ```cpp
-template <typename TKey, 
-          typename TMapped, 
-          typename TKeyCompare = etl::less<TKey>, 
+template <typename TKey,
+          typename TMapped,
+          typename TKeyCompare = etl::less<TKey>,
           typename... TPairs>
-constexpr auto make_reference_flat_map(TValues&&... values)
+constexpr auto make_reference_flat_map(TPairs&&... pairs) -> etl::reference_flat_map<TKey, TMapped, sizeof...(TPairs), TKeyCompare>
 ```
 
 ### Example
-auto data = etl::make_reference_flat_map<int, int>(etl::pair{0, 1}, etl::pair{2, 3},
-                                                   etl::pair{4, 5}, etl::pair{6, 7});
+
+{{< callout type="warning" >}}
+  This example does not currently compile: `make_reference_flat_map` cannot be
+  instantiated, because the reference containers have no `initializer_list`
+  constructor for its braced return value to bind to. This is a known defect.
+{{< /callout >}}
+
+```cpp
+// The referenced objects must outlive the container.
+etl::pair<int, int> p0{0, 1};
+etl::pair<int, int> p1{2, 3};
+etl::pair<int, int> p2{4, 5};
+etl::pair<int, int> p3{6, 7};
+
+auto data = etl::make_reference_flat_map<int, int>(p0, p1, p2, p3);
+```
 
 ## Member types
 
diff --git a/docs/containers/maps/reference-flat-multimap.md b/docs/containers/maps/reference-flat-multimap.md
index 9d4ccd64..01bdb556 100644
--- a/docs/containers/maps/reference-flat-multimap.md
+++ b/docs/containers/maps/reference-flat-multimap.md
@@ -36,19 +36,32 @@ etl::reference_flat_multimap data{ etl::pair{0, 1}, etl::pair{2, 3}, etl::pair{4
 Defines data as an reference_flat_multimap of int, of length 4, containing the supplied data.
 
 ## Make template
-C++11 and above
-
+**C++11 and above**
 ```cpp
-template <typename TKey, 
-          typename TMapped, 
-          typename TKeyCompare = etl::less<TKey>, 
+template <typename TKey,
+          typename TMapped,
+          typename TKeyCompare = etl::less<TKey>,
           typename... TPairs>
-constexpr auto make_reference_flat_map(TValues&&... values)
+constexpr auto make_reference_flat_multimap(TPairs&&... pairs) -> etl::reference_flat_multimap<TKey, TMapped, sizeof...(TPairs), TKeyCompare>
 ```
 
 ### Example
-auto data = etl::make_reference_flat_multimap<int, int>(etl::pair{0, 1}, etl::pair{2, 3},
-                                                   etl::pair{4, 5}, etl::pair{6, 7});
+
+{{< callout type="warning" >}}
+  This example does not currently compile: `make_reference_flat_multimap` cannot be
+  instantiated, because the reference containers have no `initializer_list`
+  constructor for its braced return value to bind to. This is a known defect.
+{{< /callout >}}
+
+```cpp
+// The referenced objects must outlive the container.
+etl::pair<int, int> p0{0, 1};
+etl::pair<int, int> p1{2, 3};
+etl::pair<int, int> p2{4, 5};
+etl::pair<int, int> p3{6, 7};
+
+auto data = etl::make_reference_flat_multimap<int, int>(p0, p1, p2, p3);
+```
 
 ## Member types
 
diff --git a/docs/containers/maps/unordered-map.md b/docs/containers/maps/unordered-map.md
index bf2810ad..ba576cd6 100644
--- a/docs/containers/maps/unordered-map.md
+++ b/docs/containers/maps/unordered-map.md
@@ -44,17 +44,17 @@ C++11 and above
 
 ```cpp
 template <typename TKey, 
-          typename TValue, 
-          typename THash       = etl::hash<TKey>, 
-          typename TKeyEqual   = etl::equal_to<TKey>
+          typename T,
+          typename THash      = etl::hash<TKey>,
+          typename TKeyEqual  = etl::equal_to<TKey>,
           typename... TPairs>
-constexpr auto make_unordered_map(TValues&&... values)
+constexpr auto make_unordered_map(TPairs&&... pairs) -> etl::unordered_map<TKey, T, sizeof...(TPairs), sizeof...(TPairs), THash, TKeyEqual>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_unordered_map<int, int>(etl::pair{0, 1}, etl::pair{2, 3}, 
-                                              etl::pair{4, 5}, etl::pair{6, 7});
+auto data = etl::make_unordered_map<int, int>(etl::pair<int, int>{0, 1}, etl::pair<int, int>{2, 3},
+                                              etl::pair<int, int>{4, 5}, etl::pair<int, int>{6, 7});
 ```
 
 ## Member types
diff --git a/docs/containers/maps/unordered-multimap.md b/docs/containers/maps/unordered-multimap.md
index 5e50cba3..9622f558 100644
--- a/docs/containers/maps/unordered-multimap.md
+++ b/docs/containers/maps/unordered-multimap.md
@@ -42,17 +42,17 @@ C++11 and above
 
 ```cpp
 template <typename TKey, 
-          typename TValue, 
-          typename THash       = etl::hash<TKey>, 
-          typename TKeyEqual   = etl::equal_to<TKey>
+          typename T,
+          typename THash      = etl::hash<TKey>,
+          typename TKeyEqual  = etl::equal_to<TKey>,
           typename... TPairs>
-constexpr auto make_unordered_map(TValues&&... values)
+constexpr auto make_unordered_multimap(TPairs&&... pairs) -> etl::unordered_multimap<TKey, T, sizeof...(TPairs), sizeof...(TPairs), THash, TKeyEqual>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_unordered_map<int, int>(etl::pair{0, 1}, etl::pair{2, 3}, 
-                                              etl::pair{4, 5}, etl::pair{6, 7});
+auto data = etl::make_unordered_multimap<int, int>(etl::pair<int, int>{0, 1}, etl::pair<int, int>{2, 3},
+                                                   etl::pair<int, int>{4, 5}, etl::pair<int, int>{6, 7});
 ```
 
 ## Member types
diff --git a/docs/containers/queues & stacks/deque.md b/docs/containers/queues & stacks/deque.md
index a4960607..f326e308 100644
--- a/docs/containers/queues & stacks/deque.md	
+++ b/docs/containers/queues & stacks/deque.md	
@@ -32,9 +32,11 @@ etl::deque data{ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
 Defines data as an `deque` of `int`, of length `10`, containing the supplied data.
 
 ## Make template
+**C++11 and above**
+```cpp
 template <typename T, typename... TValues>
-  constexpr auto make_deque(TValues&&... values)
-  C++11 and above
+constexpr auto make_deque(TValues&&... values) -> etl::deque<T, sizeof...(TValues)>
+```
 
 ### Example
 ```cpp
diff --git a/docs/containers/sets/flat-multiset.md b/docs/containers/sets/flat-multiset.md
index 890fcd52..d88e4a17 100644
--- a/docs/containers/sets/flat-multiset.md
+++ b/docs/containers/sets/flat-multiset.md
@@ -33,17 +33,18 @@ etl::flat_multiset data{ 0, 1, 2, 3 };
 ```
 Defines data as an `flat_multiset` of `int`, of length 4, containing the supplied data.
 
-## make_flat_set
+## make_flat_multiset
 C++11 and above
 ```cpp
-template <typename T,
-          typename TKeyCompare = etl::less<T>>
-constexpr auto make_flat_set(TValues&&... values)
+template <typename TKey,
+          typename TKeyCompare = etl::less<TKey>,
+          typename... T>
+constexpr auto make_flat_multiset(T&&... keys) -> etl::flat_multiset<TKey, sizeof...(T), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_flat_set<int>({0, 1, 2, 3 });
+auto data = etl::make_flat_multiset<int>(0, 1, 2, 3);
 ```
 
 ## Member types
diff --git a/docs/containers/sets/flat-set.md b/docs/containers/sets/flat-set.md
index 6f9c0540..e5c08610 100644
--- a/docs/containers/sets/flat-set.md
+++ b/docs/containers/sets/flat-set.md
@@ -36,14 +36,15 @@ Defines data as an `flat_set` of `int`, of length 4, containing the supplied dat
 ## make_flat_set
 C++11 and above
 ```cpp
-template <typename T,
-          typename TKeyCompare = etl::less<T>>
-constexpr auto make_flat_set(TValues&&... values)
+template <typename TKey,
+          typename TKeyCompare = etl::less<TKey>,
+          typename... T>
+constexpr auto make_flat_set(T&&... keys) -> etl::flat_set<TKey, sizeof...(T), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_flat_set<int>({0, 1, 2, 3 });
+auto data = etl::make_flat_set<int>(0, 1, 2, 3);
 ```
 
 ## Member types
diff --git a/docs/containers/sets/multiset.md b/docs/containers/sets/multiset.md
index 9bf091c8..4e3de78f 100644
--- a/docs/containers/sets/multiset.md
+++ b/docs/containers/sets/multiset.md
@@ -37,13 +37,13 @@ Defines data as an multiset of `int`, of length 8, containing the supplied data.
 ```cpp
 template <typename TKey, 
           typename TKeyCompare = etl::less<TKey>, 
-          typename... TPairs>
-constexpr auto make_set(TValues&&... values)
+          typename... T>
+constexpr auto make_multiset(T&&... keys) -> etl::multiset<TKey, sizeof...(T), TKeyCompare>
 ```
 
 ### Example
 ```cpp
-auto data = etl::make_set<int>(0, 1, 2, 3, 4, 5, 6, 7);
+auto data = etl::make_multiset<int>(0, 1, 2, 3, 4, 5, 6, 7);
 ```
 
 ## Member types
diff --git a/docs/containers/sets/reference-flat-multiset.md b/docs/containers/sets/reference-flat-multiset.md
index 9e7dd725..9bb622dc 100644
--- a/docs/containers/sets/reference-flat-multiset.md
+++ b/docs/containers/sets/reference-flat-multiset.md
@@ -32,13 +32,35 @@ etl::reference_flat_setdata{ 0, 1, 2, 3, 4, 5, 6, 7 };
 Defines data as a set of int/int pairs, of length 8, containing the supplied data.
 
 ## Make template
-C++11 and above
-template <typename TKey
+**C++11 and above**
+```cpp
+template <typename TKey,
+          typename TKeyCompare = etl::less<TKey>,
           typename... T>
-constexpr auto make_reference_flat_set(T&&... values)
+constexpr auto make_reference_flat_multiset(T&&... keys) -> etl::reference_flat_multiset<TKey, sizeof...(T), TKeyCompare>
+```
 
 ### Example
-auto data = etl::make_reference_flat_set<int>(0, 1, 2, 3, 4, 5, 6, 7);
+
+{{< callout type="warning" >}}
+  This example does not currently compile: `make_reference_flat_multiset` cannot be
+  instantiated, because the reference containers have no `initializer_list`
+  constructor for its braced return value to bind to. This is a known defect.
+{{< /callout >}}
+
+```cpp
+// The referenced objects must outlive the container.
+int k0 = 0;
+int k1 = 1;
+int k2 = 2;
+int k3 = 3;
+int k4 = 4;
+int k5 = 5;
+int k6 = 6;
+int k7 = 7;
+
+auto data = etl::make_reference_flat_multiset<int>(k0, k1, k2, k3, k4, k5, k6, k7);
+```
 
 ## Member types
 
diff --git a/docs/containers/sets/reference-flat-set.md b/docs/containers/sets/reference-flat-set.md
index da2c9dc9..8ff1e296 100644
--- a/docs/containers/sets/reference-flat-set.md
+++ b/docs/containers/sets/reference-flat-set.md
@@ -32,13 +32,35 @@ etl::reference_flat_setdata{ 0, 1, 2, 3, 4, 5, 6, 7 };
 Defines data as a set of int/int pairs, of length 8, containing the supplied data.
 
 ## Make template
-C++11 and above
-template <typename TKey
+**C++11 and above**
+```cpp
+template <typename TKey,
+          typename TKeyCompare = etl::less<TKey>,
           typename... T>
-constexpr auto make_reference_flat_set(T&&... values)
+constexpr auto make_reference_flat_set(T&&... keys) -> etl::reference_flat_set<TKey, sizeof...(T), TKeyCompare>
+```
 
 ### Example
-auto data = etl::make_reference_flat_set<int>(0, 1, 2, 3, 4, 5, 6, 7);
+
+{{< callout type="warning" >}}
+  This example does not currently compile: `make_reference_flat_set` cannot be
+  instantiated, because the reference containers have no `initializer_list`
+  constructor for its braced return value to bind to. This is a known defect.
+{{< /callout >}}
+
+```cpp
+// The referenced objects must outlive the container.
+int k0 = 0;
+int k1 = 1;
+int k2 = 2;
+int k3 = 3;
+int k4 = 4;
+int k5 = 5;
+int k6 = 6;
+int k7 = 7;
+
+auto data = etl::make_reference_flat_set<int>(k0, k1, k2, k3, k4, k5, k6, k7);
+```
 
 ## Member types
 
diff --git a/docs/containers/sets/set.md b/docs/containers/sets/set.md
index cec118bd..b6da157f 100644
--- a/docs/containers/sets/set.md
+++ b/docs/containers/sets/set.md
@@ -36,9 +36,9 @@ Defines data as an set of `int`, of length 8, containing the supplied data.
 
 ```cpp
 template <typename TKey, 
-          typename TKeyCompare = etl::less<TKey>, 
-          typename... TPairs>
-constexpr auto make_set(TValues&&... values)
+          typename TCompare = etl::less<TKey>,
+          typename... T>
+constexpr auto make_set(T&&... keys) -> etl::set<TKey, sizeof...(T), TCompare>
 ```
 
 ### Example