From ea8a93ee7211c90137fcf8287820b021dd0dc0c1 Mon Sep 17 00:00:00 2001
From: David Piggott <david@piggott.me.uk>
Date: Wed, 9 Aug 2023 14:58:16 +0100
Subject: [PATCH] Refine README structure

---
 README.md | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index f942ae3..261ff5a 100644
--- a/README.md
+++ b/README.md
@@ -35,9 +35,8 @@ A collection of commonly used Smithy shapes.
   - [alloy#structurePattern](#alloystructurepattern)
   - [alloy.openapi](#alloyopenapi)
     - [alloy.openapi#openapiExtensions](#alloyopenapiopenapiextensions)
-  - [alloy#urlForm](#alloyurlform)
-    - [alloy#urlFormFlattened](#alloyurlformflattened)
-    - [alloy#urlFormName](#alloyurlformname)
+  - [alloy#urlFormFlattened](#alloyurlformflattened)
+  - [alloy#urlFormName](#alloyurlformname)
 - [Protocol Compliance Module](#protocol-compliance-module)
   - [Using the Protocol Compliance Tests](#using-the-protocol-compliance-tests)
 - [Working on Alloy](#working-on-alloy)
@@ -556,13 +555,9 @@ list StringList {
 }
 ```
 
-### alloy.urlForm
+#### alloy#urlFormFlattened
 
-url-form data equivalents of `xmlName` and `xmlFlattened`.
-
-#### alloy.urlFormFlattened
-
-Unwraps the values of a list, set, or map into the containing structure/union when serialized as url-form data.
+url-form data equivalent of `xmlFlattened`. Unwraps the values of a list, set, or map into the containing structure/union when serialized as url-form data.
 
 ```smithy
 structure User {
@@ -576,9 +571,9 @@ list StringList {
 }
 ```
 
-Changes the serialized url-form data key of a structure, union, or member.
+#### alloy#urlFormName
 
-#### alloy.urlFormName
+url-form data equivalent of `xmlName`. Changes the serialized url-form data key of a structure, union, or member.
 
 ```smithy
 structure User {