Issue #3332574: Update README.md file according to README.md template

README.md

-CONTENTS OF THIS FILE
----------------------
+# CAPTCHA Riddler - Human Question & Answer Captcha
 
- * Introduction
- * Requirements
- * Installation
- * Configuration
- * Maintainers
+Captcha Riddler is a sub module of Captcha that lets site
+administrators create their own questions to foil
+automated spam bots.
 
+For a full description of the module, visit the
+[project page](https://www.drupal.org/project/riddler).
 
-INTRODUCTION
-------------
+Submit bug reports and feature suggestions, or track changes in the
+[issue queue](https://www.drupal.org/project/issues/riddler).
 
-Captcha Riddler is a sub module of Captcha that lets site administrators create their own questions to foil automated spam bots.
 
- * For a full description of the module, visit the project page:
-   https://www.drupal.org/project/riddler
+## Table of contents
 
- * To submit bug reports and feature suggestions, or to track changes:
-   https://www.drupal.org/project/issues/riddler
+- Requirements
+- Installation
+- Configuration
+- Usage
+- Maintainers
 
 
-REQUIREMENTS
-------------
+## Requirements
 
-This module requires the Captcha module:
+This module requires the following modules:
 
- * Captcha (https://www.drupal.org/project/captcha)
+- [Captcha](https://www.drupal.org/project/captcha)
 
 
-INSTALLATION
-------------
+## Installation
 
- * Install as you would normally install a contributed Drupal module. Visit
-   https://www.drupal.org/node/1897420 for further information.
+Install as you would normally install a contributed Drupal module. For further
+information, see
+[Installing Drupal Modules](https://www.drupal.org/docs/extending-drupal/installing-drupal-modules).
 
 
-CONFIGURATION
--------------
+## Configuration
 
-To create a new riddle and get an overview of all created riddles head to
-Configuration > People > CAPTCHA Module Settings > Riddler Riddles
-(`/admin/config/people/captcha/riddler-riddle`)
+1. To create a new riddle and get an overview of all created riddles head to
+   Configuration > People > CAPTCHA Module Settings > Riddler Riddles
+   (`/admin/config/people/captcha/riddler-riddle`)
 
-Here you have a table of all created riddles, where you can edit, delete and
-translate these riddles.
+2. Here you have a table of all created riddles, where you can edit, delete and
+   translate these riddles.
 
-Click 'Add riddle' to add questions that you require users to answer.
+3. Click 'Add riddle' to add questions that you require users to answer.
 
-A random question will be presented to the user on forms as configured in the
-CAPTCHA settings. Allow more than one correct answer on a question by entering a
-comma-separated list in the "Solution" field of a riddle.
+4. A random question will be presented to the user on forms as configured in the
+   CAPTCHA settings. Allow more than one correct answer on a question by entering a
+   comma-separated list in the "Solution" field of a riddle.
 
-USAGE
------
 
-To activate the riddler challenge type on a CAPTCHA point, go
-to Configuration > People > CAPTCHA settings > Form settings
-(`/admin/config/people/captcha/captcha-points`), edit the CAPTCHA point of your
-choosing and set the "Challenge type" to "Riddler".
+## Usage
 
-Alternatively, you can also set the Riddler challenge type as your "Default
-challenge type" under Configuration > People > CAPTCHA Settings
-(`/admin/config/people/captcha`).
+- To activate the riddler challenge type on a CAPTCHA point, go
+  to Configuration > People > CAPTCHA settings > Form settings
+  (`/admin/config/people/captcha/captcha-points`), edit the CAPTCHA point of your
+  choosing and set the "Challenge type" to "Riddler".
 
+- Alternatively, you can also set the Riddler challenge type as your "Default
+  challenge type" under Configuration > People > CAPTCHA Settings
+  (`/admin/config/people/captcha`).
 
-MAINTAINERS
------------
 
- * Oleksandr Bazyliuk (alex_optim) - https://www.drupal.org/u/alex_optim
- * Aaron Wolfe (awolfey) - https://www.drupal.org/u/awolfey
- * imerlin - https://www.drupal.org/u/imerlin
- * Julian Pustkuchen (Anybody) - https://www.drupal.org/u/anybody
- * Joshua Sedler (Grevil) - https://www.drupal.org/u/grevil
+## Maintainers
+
+- Thomas Frobieter - [thomas.frobieter](https://www.drupal.org/u/thomasfrobieter)
+- Oleksandr Bazyliuk - [alex_optim](https://www.drupal.org/u/alex_optim)
+- Aaron Wolfe - [awolfey](https://www.drupal.org/u/awolfey)
+- imerlin - [imerlin](https://www.drupal.org/u/imerlin)
+- Julian Pustkuchen - [Anybody](https://www.drupal.org/u/anybody)
+- Joshua Sedler - [Grevil](https://www.drupal.org/u/grevil)
 
 
 Supporting organizations:
 
- * Singlebrook Technology - https://www.drupal.org/singlebrook-technology
- * Drupal Ukraine Community - https://www.drupal.org/drupal-ukraine-community
- * GOLEMS GABB - https://www.drupal.org/golems-gabb
+- [Singlebrook Technology](https://www.drupal.org/singlebrook-technology)
+- [Drupal Ukraine Community](https://www.drupal.org/drupal-ukraine-community)
+- [GOLEMS GABB](https://www.drupal.org/golems-gabb)