Update README.md

README.md

@@ -9,19 +9,16 @@
 An elegant option parser and generator for shell scripts (sh, bash and all POSIX shells)
 
 getoptions is a new option parser and generator released in 2020.
-It's simple, easy-to-use, fast, small, flexible, extensible, portable and POSIX compliant. No more any loops and templates needed!
-
-- [getoptions.sh](./lib/getoptions.sh) - base module
-- [getoptions_abbr.sh](./lib/getoptions_abbr.sh) - abbreviation option module (add-on)
-- [getoptions_help.sh](./lib/getoptions_help.sh) - help module (add-on)
+It's simple, easy-to-use, fast, small, flexible, extensible, portable and POSIX compliant.
+No more any loops and templates needed!
 
 ## Table of Contents <!-- omit in toc -->
 
-- [Requirements](#requirements)
 - [Comparison](#comparison)
   - [with other implementations](#with-other-implementations)
   - [`getopt` vs `getopts` vs `getoptions`](#getopt-vs-getopts-vs-getoptions)
 - [Installation](#installation)
+- [Requirements](#requirements)
 - [Usage](#usage)
   - [Basic](#basic)
   - [Subcommand](#subcommand)
@@ -52,11 +49,6 @@ It's simple, easy-to-use, fast, small, flexible, extensible, portable and POSIX
 - [Changelog](#changelog)
 - [License](#license)
 
-## Requirements
-
-- No requirements for option parsing (POSIX shell only)
-- `cat` is required for optional automatic help generation
-
 ## Comparison
 
 ### with other implementations
@@ -130,8 +122,17 @@ git clone https://github.com/ko1nksm/getoptions.git
 Copy the necessary files under the [lib](lib) directory to your project or
 use the code generated by the `bin/getoptions` command in your project.
 
+## Requirements
+
+- No requirements for option parsing (POSIX shell only)
+- `cat` is required for optional automatic help generation
+
 ## Usage
 
+- [getoptions.sh](./lib/getoptions.sh) - Base module
+- [getoptions_abbr.sh](./lib/getoptions_abbr.sh) - Abbreviation option module (add-on)
+- [getoptions_help.sh](./lib/getoptions_help.sh) - Automatic help generation module (add-on)
+
 ### Basic
 
 ```sh
@@ -200,10 +201,10 @@ sample/advanced.sh --help
 See [advanced.sh](sample/advanced.sh)
 
 getoptions was originally developed to improve the maintainability and testability for [ShellSpec][shellspec]
-which has number of options. [ShellSpec usage][shellspec_usage] is another good example of how to use getoptions.
+which has number of options. [ShellSpec optparser][optparser] is another good example of how to use getoptions.
 
 [shellspec]: https://shellspec.info/
-[shellspec_usage]: https://github.com/shellspec/shellspec/tree/master/lib/libexec/optparser
+[optparser]: https://github.com/shellspec/shellspec/tree/master/lib/libexec/optparser
 
 ### Extension
 
@@ -244,7 +245,7 @@ bin/getoptions --indent=2 --shellcheck sample/parser_definition.sh parser prog
 <details>
 <summary>generated code</summary>
 
-```
+```sh
 # shellcheck shell=sh
 # Generated by getoptions (BEGIN)
 # URL: https://github.com/ko1nksm/getoptions (2.3.0)
@@ -392,6 +393,7 @@ GETOPTIONSHERE
 }
 # Generated by getoptions (END)
 ```
+
 </details>
 
 ## NOTE: 2.x breaking changes