Changelog-None

Author: greggzigler

doc/STYLE.md

@@ -198,7 +198,7 @@ for programs to deal with them sanely, and also perform translations.
 
 We use JSON schemas to validate that JSON-RPC returns are in the
 correct form, and also to generate documentation.  See
-[WRITING_SCHEMAS.md](schemas/WRITING_SCHEMAS.md).
+[writing schemas manpage](schemas/WRITING_SCHEMAS.md).
 
 ## Changing JSON APIs
 

doc/schemas/WRITING_SCHEMAS.md

@@ -5,10 +5,10 @@ look like; in our case we use it in our testsuite to check that they
 match command responses, and also use it to generate our
 documentation.
 
-Yes, schemas are horrible to write, but they're damn useful.  We can
-only use a subset of the full [https://json-schema.org/](JSON Schema
-Specification), but if you find that limiting it's probably a sign
-that you should simplify your JSON output.
+Yes, schemas are horrible to write, but they're damn useful.  We can only
+use a subset of the full [JSON Schema Specification](https://json-schema.org/),
+but if you find that limiting it's probably a sign that you should simplify
+your JSON output.
 
 ## How to Write a Schema