diff --git a/doc/manual/example.md b/doc/manual/example.md
index b4f04f4..39ea682 100644
--- a/doc/manual/example.md
+++ b/doc/manual/example.md
@@ -1 +1,3 @@
-# Example
+# Examples
+
+> More examples in [the test files](https://github.com/codec-bytes/base16/tree/main/test/src).
diff --git a/doc/manual/installation.md b/doc/manual/installation.md
index 4d48228..6b40337 100644
--- a/doc/manual/installation.md
+++ b/doc/manual/installation.md
@@ -1,15 +1,22 @@
 # Installation
 
 Can be managed using
-[jspm](http://jspm.io)
-or [npm](https://github.com/npm/npm).
+[yarn](https://yarnpkg.com/en/docs),
+[npm](https://docs.npmjs.com),
+or [jspm](https://jspm.org/docs).
 
-### jspm
+
+### yarn
 ```terminal
-jspm install npm:@codec-bytes/base16
+yarn add @codec-bytes/base16
 ```
 
 ### npm
 ```terminal
 npm install @codec-bytes/base16 --save
 ```
+
+### jspm
+```terminal
+jspm install npm:@codec-bytes/base16
+```
diff --git a/doc/manual/usage.md b/doc/manual/usage.md
index b87e15a..ea4c2a6 100644
--- a/doc/manual/usage.md
+++ b/doc/manual/usage.md
@@ -1,16 +1,19 @@
 # Usage
 
-The code needs a ES2015+ polyfill to work, for example
-[regenerator-runtime/runtime](https://babeljs.io/docs/usage/polyfill).
+> :warning: Depending on your environment, the code may require
+> `regeneratorRuntime` to be defined, for instance by importing
+> [regenerator-runtime/runtime](https://www.npmjs.com/package/regenerator-runtime).
+
+First, require the polyfill at the entry point of your application
 ```js
-await import( 'regenerator-runtime/runtime.js' ) ;
+await import('regenerator-runtime/runtime.js');
 // or
-import 'regenerator-runtime/runtime.js' ;
+import 'regenerator-runtime/runtime.js';
 ```
 
-Then
+Then, import the library where needed
 ```js
-const codecbase16 = await import( '@codec-bytes/base16' ) ;
+const {encode, decode} = await import('@codec-bytes/base16');
 // or
-import * as codecbase16 from '@codec-bytes/base16' ;
+import {encode, decode} from '@codec-bytes/base16';
 ```