diff --git a/docs/notes/development.md b/docs/development.md
similarity index 82%
rename from docs/notes/development.md
rename to docs/development.md
index 0f4e336..cb71aea 100644
--- a/docs/notes/development.md
+++ b/docs/development.md
@@ -1,12 +1,17 @@
-## Development
+---
+title: Development
+editLink: false
+---
 
 PEG.js is currently maintained by [Futago-za Ryuu](https://github.com/futagoza) ([@futagozaryuu](https://twitter.com/futagozaryuu)).
 
 Since it's [inception](https://www.google.com/search?q=inception+meaning) in 2010, PEG.js was maintained by [David Majda](https://majda.cz/) ([@dmajda](http://twitter.com/dmajda)), until [May 2017](https://github.com/pegjs/pegjs/issues/503).
 
-The [Bower package](https://github.com/pegjs/bower) is maintained by [Michel Krämer](http://www.michel-kraemer.com/) ([@michelkraemer](https://twitter.com/michelkraemer)).
+::: warning
+The [Bower package](https://github.com/pegjs/bower) (which was maintained by [Michel Krämer](http://www.michel-kraemer.com/) ([@michelkraemer](https://twitter.com/michelkraemer))) has been deprecated, and will no longer be updated.
+:::
 
-### Contribution
+## Contribute
 
 You are welcome to contribute code using [GitHub pull requests](https://github.com/pegjs/pegjs/pulls). Unless your contribution is really trivial you should get in touch with me first (preferably by creating a new issue on the [issue tracker](https://github.com/pegjs/pegjs/issues)) - this can prevent wasted effort on both sides.
 
@@ -14,7 +19,7 @@ You are welcome to contribute code using [GitHub pull requests](https://github.c
 
 _Ensure you have Node.js v6+ and Yarn installed._
 
-1. Create a fork of https://github.com/pegjs/pegjs
+1. Create a fork of [https://github.com/pegjs/pegjs](https://github.com/pegjs/pegjs)
 2. Clone your fork, and optionally create a new branch
 3. Run the command `yarn install` from the root of your clone
 4. Add and commit your changes
@@ -30,3 +35,5 @@ _Ensure you have Node.js v6+ and Yarn installed._
 It's also a good idea to check out the [package.json](https://github.com/pegjs/pegjs/blob/master/package.json) that defines various scripts.
 
 To see the list of contributors check out the [repository's contributors page](https://github.com/pegjs/pegjs/graphs/contributors).
+
+<PageFooter />
diff --git a/docs/notes/compatibility.md b/docs/guides/compatibility.md
similarity index 95%
rename from docs/notes/compatibility.md
rename to docs/guides/compatibility.md
index 440cdb1..d561e5b 100644
--- a/docs/notes/compatibility.md
+++ b/docs/guides/compatibility.md
@@ -7,5 +7,4 @@ Both the parser generator and generated parsers should run well in the following
 * Microsoft Edge
 * Firefox
 * Chrome
-* Safari
 * Opera
diff --git a/docs/notes/useful-links.md b/docs/notes/useful-links.md
deleted file mode 100644
index b1d8b29..0000000
--- a/docs/notes/useful-links.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## Useful Links
-
-* [Project website](https://pegjs.org/)
-* [Wiki](https://github.com/pegjs/pegjs/wiki)
-* [Source code](https://github.com/pegjs/pegjs)
-* [Issue tracker](https://github.com/pegjs/pegjs/issues)
-* [Google Group](http://groups.google.com/group/pegjs)
-* [Stack Overflow](https://stackoverflow.com/questions/tagged/pegjs)
-* [Twitter](https://twitter.com/pegjs)