Update README and documentation index (#1324)

Author: chrisrink10

README.md

@@ -1,14 +1,15 @@
 # 🐍 basilisp 🐍
 
-A Clojure-compatible(-ish) Lisp dialect targeting Python 3.10+.
+A Clojure-compatible(-ish) Lisp dialect hosted on Python 3 with seamless Python
+interop.
 
-[![PyPI](https://img.shields.io/pypi/v/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![python](https://img.shields.io/pypi/pyversions/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![pyimpl](https://img.shields.io/pypi/implementation/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![readthedocs](https://img.shields.io/readthedocs/basilisp.svg?style=flat-square)](https://basilisp.readthedocs.io/) [![Run tests](https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml) [![Coveralls github](https://img.shields.io/coveralls/github/basilisp-lang/basilisp.svg?style=flat-square)](https://coveralls.io/github/basilisp-lang/basilisp) [![license](https://img.shields.io/github/license/basilisp-lang/basilisp.svg?style=flat-square)](https://github.com/basilisp-lang/basilisp/blob/master/LICENSE) [![Slack](https://img.shields.io/badge/Slack-Clojurians-green?style=flat-square)](https://clojurians.slack.com/archives/C071RFV2Z1D)
+[![PyPI](https://img.shields.io/pypi/v/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![python](https://img.shields.io/pypi/pyversions/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![pyimpl](https://img.shields.io/pypi/implementation/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![readthedocs](https://img.shields.io/readthedocs/basilisp.svg?style=flat-square)](https://basilisp.readthedocs.io/) [![Run tests](https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml) [![Run clojure-test-suite](https://github.com/basilisp-lang/basilisp/actions/workflows/run-clojure-test-suite.yml/badge.svg?branch=main)](https://github.com/basilisp-lang/basilisp/actions/workflows/run-clojure-test-suite.yml) [![Coveralls github](https://img.shields.io/coveralls/github/basilisp-lang/basilisp.svg?style=flat-square)](https://coveralls.io/github/basilisp-lang/basilisp) [![license](https://img.shields.io/github/license/basilisp-lang/basilisp.svg?style=flat-square)](https://github.com/basilisp-lang/basilisp/blob/master/LICENSE) [![Slack](https://img.shields.io/badge/Slack-Clojurians-green?style=flat-square)](https://clojurians.slack.com/archives/C071RFV2Z1D)
 
 ## Getting Started
 
 Basilisp is developed on [GitHub](https://github.com/basilisp-lang/basilisp) and
 hosted on [PyPI](https://pypi.python.org/pypi/basilisp). You can fetch Basilisp
-using `pip`:
+using `pip` (or any other Python dependency manager which can pull from PyPI):
 
 ```bash
 pip install basilisp
@@ -20,27 +21,24 @@ Once Basilisp is installed, you can enter into the REPL using:
 basilisp repl
 ```
 
-Basilisp [documentation](https://basilisp.readthedocs.io) can help guide your
-exploration at the REPL. Additionally, Basilisp features many of the same functions
-and idioms as [Clojure](https://clojure.org/), so you may find guides and
-documentation there helpful for getting started.
+## Documentation
+
+Basilisp [documentation](https://docs.basilisp.org) can help guide your
+exploration at the REPL and beyond. Additionally, Basilisp features many of the
+same functions and idioms as [Clojure](https://clojure.org/), so you may find
+guides and documentation there helpful for getting started.
 
 For those who prefer a video introduction, feel free to check out this
 [talk](https://youtu.be/ruGRHYpq448?si=0jr2a6uWlq6Vi2_k) hosted by the
 [London Clojurians](https://www.meetup.com/london-clojurians/) group about Basilisp.
 
-## Why does this project exist?
-
-Basilisp is a project I (@chrisrink10) created to learn about Python, Clojure,
-hosted  languages, and compilers.
+## Contributing
 
-That said, it is generally stable at this point with reasonably high test
-coverage, linting, and type checking. Work is ongoing to complete the rest of the
-standard library implementations. I suspect it could be used to build small
-applications and tools at this point, though I would not recommend it unless you
-like being an early adopter.
+Contributions are welcome, but please review the [contributing guidelines](https://docs.basilisp.org/en/latest/contributing.html)
+before submitting an issue or pull request.
 
-_Use in a production setting at your own risk._
+If you have a question, please use [Github Discussions](https://github.com/basilisp-lang/basilisp/discussions)
+or post in the [`#basilisp` channel](https://clojurians.slack.com/archives/C0A2CQQQVPB) in the Clojurians Slack.
 
 ## License
 

docs/index.rst

@@ -6,7 +6,35 @@
 Welcome to Basilisp's documentation!
 ====================================
 
-Basilisp is a :ref:`Clojure-compatible(-ish) <differences_from_clojure>` Lisp dialect targeting Python 3.10+.
+.. image:: https://img.shields.io/badge/Github-basilisp-green?style=flat-square
+   :target: https://github.com/basilisp-lang/basilisp
+   :alt: Link to Basilisp Github repository
+.. image:: https://img.shields.io/pypi/v/basilisp.svg?style=flat-square
+   :target: https://pypi.org/project/basilisp/
+   :alt: Link to Basilisp PyPI page for current release; shows the current release version
+.. image:: https://img.shields.io/pypi/pyversions/basilisp.svg?style=flat-square
+   :target: https://pypi.org/project/basilisp/
+   :alt: Link to Basilisp PyPI page for current release; shows currently supported Python versions
+.. image:: https://img.shields.io/readthedocs/basilisp.svg?style=flat-square
+   :target: https://docs.basilisp.org
+   :alt: Link to Basilisp documentation
+.. image:: https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml/badge.svg?branch=main&style=flat-square
+   :target: https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml
+   :alt: Link to Basilisp test CI workflow on Github Actions
+.. image:: https://github.com/basilisp-lang/basilisp/actions/workflows/run-clojure-test-suite.yml/badge.svg?branch=main&style=flat-square
+   :target: https://github.com/basilisp-lang/basilisp/actions/workflows/run-clojure-test-suite.yml
+   :alt: Link to Basilisp clojure-test-suite CI workflow on Github Actions
+.. image:: https://img.shields.io/coveralls/github/basilisp-lang/basilisp.svg?style=flat-square
+   :target: https://coveralls.io/github/basilisp-lang/basilisp
+   :alt: Link to Basilisp Coverage report on Coveralls
+.. image:: https://img.shields.io/github/license/basilisp-lang/basilisp.svg?style=flat-square
+   :target: https://github.com/basilisp-lang/basilisp/blob/master/LICENSE
+   :alt: Link to Basilisp license file
+.. image:: https://img.shields.io/badge/Slack-Clojurians-green?style=flat-square
+   :target: https://clojurians.slack.com/archives/C071RFV2Z1D
+   :alt: Link to Basilisp channel on Clojurians Slack
+
+Basilisp is a :ref:`Clojure-compatible(-ish) <differences_from_clojure>` Lisp dialect hosted on Python 3 with seamless Python interop.
 
 Basilisp compiles down to raw Python 3 code and executes on the Python 3 virtual machine, allowing natural interoperability between existing Python libraries and new Lisp code.
 

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "basilisp"
 version = "0.5.0"
-description = "A Clojure-like lisp written for Python"
+description = "A Clojure-compatible(-ish) Lisp dialect hosted on Python 3 with seamless Python interop."
 authors = [
     { name = "Christopher Rink", email = "chris@crink.dev" },
 ]
@@ -11,8 +11,6 @@ requires-python = ">=3.10"
 packages = [
     { include = "basilisp", from = "src" },
 ]
-repository = "https://github.com/basilisp-lang/basilisp"
-documentation = "https://basilisp.readthedocs.io/"
 classifiers = [
     # Trove classifiers
     # Full list: https://pypi.python.org/pypi?%3Aaction=list_classifiers
@@ -38,6 +36,13 @@ dependencies = [
     "typing-extensions (>=4.7.0,<5.0.0)",
 ]
 
+[project.urls]
+Homepage = "https://github.com/basilisp-lang/basilisp"
+Documentation = "https://docs.basilisp.org"
+Repository = "https://github.com/basilisp-lang/basilisp"
+"Bug Tracker" = "https://github.com/basilisp-lang/basilisp/issues"
+Changelog = "https://github.com/basilisp-lang/basilisp/blob/main/CHANGELOG.md"
+
 [dependency-groups]
 dev = [
     "black >=24.0.0",