From dac3a12251628049e7f90e73ebb774295dd898a1 Mon Sep 17 00:00:00 2001
From: junkmd <45822440+junkmd@users.noreply.github.com>
Date: Thu, 29 Dec 2022 00:43:54 +0900
Subject: [PATCH] update `README.md`, and add badges. (#404)

* update `README.md`

* update `setup.classifiers` for rendering ver badge

* revert setup.py

* fix grammar and wording
---
 README.md | 52 +++++++++++++++++++++++++++++++++-------------------
 1 file changed, 33 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 207ba3367..bacdf97a4 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,45 @@
-comtypes
-========
+# comtypes
 
-**comtypes** is a lightweight Python COM package, based on the ctypes_
-FFI library, in less than 10000 lines of code (not counting the
-tests).
+[![PyPI version](https://badge.fury.io/py/comtypes.svg)](https://pypi.org/project/comtypes/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - License](https://img.shields.io/pypi/l/comtypes)](https://pypi.org/project/comtypes/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/comtypes)](https://pypi.org/project/comtypes/)
+[![GitHub Repo stars](https://img.shields.io/github/stars/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/stargazers) [![GitHub forks](https://img.shields.io/github/forks/enthought/comtypes?style=social)](https://github.com/enthought/comtypes/network/members)
 
-**comtypes** allows to define, call, and implement custom and
-dispatch-based COM interfaces in pure Python.  It works on Windows and
-64-bit Windows. Windows CE support was dropped since comtypes==1.1.8.
+## About
 
-Documentation:
+`comtypes` is a lightweight `Python` COM package, based on the [`ctypes`](https://docs.python.org/library/ctypes.html) FFI library.
 
-    https://pythonhosted.org/comtypes
+`comtypes` allows to define, call, and implement custom and dispatch-based COM interfaces in pure `Python`.
 
-    Contribute using the `source repository and issue tracker
-    <https://github.com/enthought/comtypes/>`_ on GitHub.
+This package works on Windows only.
+- [`comtypes==1.1.7`](https://pypi.org/project/comtypes/1.1.7/) is the last version supporting Windows CE.
 
-Mailing list:
+## Where to get it
 
-    http://gmane.org/info.php?group=gmane.comp.python.comtypes.user
+The source code is currently hosted on GitHub at:
+https://github.com/enthought/comtypes
 
-    https://lists.sourceforge.net/lists/listinfo/comtypes-users/
+An installer for the latest released version is available at the [Python Package Index (PyPI)](https://pypi.org/project/comtypes).
 
-Download:
+```sh
+# PyPI
+pip install comtypes
+```
 
-    Releases can be downloaded in the PyPI page:
+## Dependencies
 
-    https://pypi.python.org/pypi/comtypes
+`comtypes` requires no third-party packages to run - this is truly **pure** `Python` package.
 
-.. _ctypes: http://docs.python.org/lib/module-ctypes.html
+Optional features include the follows...
+- to process arrays as `numpy`'s `ndarray`
+- type hints be interpreted by `mypy` or several static type checkers
+
+But these third-parties are not required as a prerequisite for runtime.
+
+## Community of the developers
+
+Tracking issues, reporting bugs and contributing to the codebase and documentation are on GitHub at:
+https://github.com/enthought/comtypes
+
+## Documentation:
+
+The documentation is currently hosted on pythonhosted at:
+https://pythonhosted.org/comtypes