2nd pass at Doc in markdown (rather than Sphinx)

Author: luss

CHANGELOG

@@ -1,7 +1,8 @@
 3.1:
-   - drop support for Postgres versions prior to 14
    - add support for Python 3.13
    - add support for pg18
+   - drop support for Postgres versions prior to 14
+   - rework usage Doc from Sphinx into simple Markdown
 
 3.0:
    - drop support for Python 3 versions prior to 3.9

doc/README.md

@@ -2,7 +2,7 @@
 # Multicorn2
 
 
-Multicorn2 is a PostgreSQL 14++ extension meant to make `Foreign Data Wrapper`
+Multicorn2 is a PostgreSQL extension meant to make `Foreign Data Wrapper`
 development easy, by allowing the programmer to use the Python programming
 language.
 
@@ -11,11 +11,10 @@ If you just want to use it as soon as possible, jump straight to the
 
 
 ## Table of Contents
-  - installation.md
-  - getting-started.md
-  - foreign-data-wrappers.md
-  - implementing-an-fdw.md
-  - third-party-fdw.md
-  - internals.md
-  - contribute.md
-
+  - [Installation](installation.md)
+  - [Getting Started](getting-started.md)
+  - [Foreign Data Wrappers](foreign-data-wrappers.md)
+  - [Implementing an FDW](implementing-an-fdw.md)
+  - [Third Party FDW's](third-party-fdw.md)
+  - [Internals](internals.md)
+  - [Contribute](contribute.md)

doc/contribute.md

@@ -1,15 +1,13 @@
 # Contribute
 
-If you use Multicorn2 in production, we would love to hear about your use-case !
+If you use Multicorn2 in production, we would love to hear about your use-case!
 
 
 ## Report Bugs
 
-Found a bug? Want a new feature? Report a new issue on the  `Multicorn2
-bug-tracker on GitHub <https://github.com/pgsql-io/Multicorn2/issues/>`.
+Found a bug? Want a new feature? Use our [Issue Tracker](https://github.com/pgsql-io/multicorn2/issues/)
 
 
 ## Hack
 
-Interested in hacking? Feel free to clone the `git repository on
-GitHub <https://github.com/pgsql-io/Multicorn2>` if you want to add new features, fix bugs or update documentation.
+Interested in hacking? Feel free to clone [https://github.com/pgsql-io/Multicorn2](https://github.com/pgsql-io/multicorn2) if you want to add new features, fix bugs or update documentation.

doc/foreign-data-wrappers.md

@@ -4,10 +4,10 @@ Multicorn is bundled with a small set of Foreign Data Wrappers, which you can
 use or customize for your needs.
 
 
-  /foreign-data-wrappers/sqlalchemyfdw.md
-  /foreign-data-wrappers/fsfdw.md
-  /foreign-data-wrappers/imapfdw.md
-  /foreign-data-wrappers/ldapfdw.md
-  /foreign-data-wrappers/csvfdw.md
-  /foreign-data-wrappers/rssfdw.md
-  /foreign-data-wrappers/processfdw.md
+  - [sqlalchemy](/foreign-data-wrappers/sqlalchemyfdw.md)
+  - [fsfdw](/foreign-data-wrappers/fsfdw.md)
+  - [imapfdw](/foreign-data-wrappers/imapfdw.md)
+  - [ldapfdw](/foreign-data-wrappers/ldapfdw.md)
+  - [csvfdw](/foreign-data-wrappers/csvfdw.md)
+  - [rssfdw](/foreign-data-wrappers/rssfdw.md)
+  - [processfdw](/foreign-data-wrappers/processfdw.md)