Get ready for release 3.1.0 (yet again)

NEWS.md

@@ -1,3 +1,23 @@
+3.1.0
+-----
+
+This version builds the PDF and stores that in the docker container. As a result two new
+command and front-end shell scripts were added:
+
+* `dmathicsdoc` will run _evince_ over the Mathics book that was built when the container was built.
+* `dmathicsdoccopy` will copy the Mathics book that was built when the container was built.
+
+The script for going into `mathicsscript` has been enhanced to try to detect the terminal background.
+
+Set environment variable `COLORFGBG` to force what kind of background you have Use value `15;0` for dark backgrounds and `0;15` for light backgrounds.
+
+Two new workspaces taken from "Implementing Discrete Mathematics" have been added to Mathics Django:
+
+* C 3.1 Datastructures for Graphs
+* C 3.2 Classifying Simple Graphs
+
+Section 14: Coordinates and Graphics 3D has been revised now that the efficiency of threejs rendering has been improved. We can now easily compute 10x10 points in a box.
+
 3.0.0
 -----
 

README.rst

@@ -1,5 +1,7 @@
 |Pypi Installs| |Latest Version| |Supported Python Versions|
 
+Mathics is a general-purpose computer algebra system (CAS). It is an open-source alternative to Mathematica. It is free both as in "freedom" and as in "free beer".
+
 `Mathics <https://mathics.org>`_ consists of a number of separable components so that those pieces that are desired can be used without the burden of dependencies of the other parts.
 
 For example if you are interested in just running a command-line interface, you might not be interested in having Django and what that entails and vice versa.
@@ -13,19 +15,19 @@ That's what this repository is about. Here we have a PyPI installable package th
 * ``mathicsserver`` to run the Django-Web server,
 * ``dmathicsscript`` and ``dmathicsserver`` which runs the docker version of these,
 * ``dmathicssdoc`` which runs a PDF viewer, `evince <https://wiki.gnome.org/Apps/Evince>`_, which can view the generated reference manual in PDF.
-* ``dmathicssdoc`` which copies the the generated reference PDF manual out of the container and into the host filesystem.
+* ``dmathicssdoccopy`` which copies the the generated reference PDF manual out of the container and into the host filesystem.
 
 This repository also contains the Dockerfiles used to create the `mathicsorg/mathics docker images <https://hub.docker.com/repository/docker/mathicsorg/mathics>`_.
 
 That image is a combination of:
 
-* `Mathics-Scanner <https://github.com/Mathics3/mathics-scanner>`_
-* `mathicsscript <https://github.com/Mathics3/mathicsscript>`_
-* `mathics-pygments <https://github.com/Mathics3/mathics-pygments>`_
-* `Mathics-Django <https://github.com/Mathics3/Mathics-Django>`_
-* `mathics-threejs-backend <https://github.com/Mathics3/mathics-threejs-backend>`_
-* `pymathics-natlang <https://github.com/Mathics3/pymathics-natlang>`_
-* `pymathics-graph <https://github.com/Mathics3/pymathics-graph>`_
+* `Mathics-Scanner <https://github.com/Mathics3/mathics-scanner>`_ (WL Character Tables and Mathics Scanner)
+* `mathicsscript <https://github.com/Mathics3/mathicsscript>`_ (Command-line Mathics Interface)
+* `mathics-pygments <https://github.com/Mathics3/mathics-pygments>`_ (WL Syntax Highlighting)
+* `Mathics-Django <https://github.com/Mathics3/Mathics-Django>`_ (Django-based HTTP server)
+* `mathics-threejs-backend <https://github.com/Mathics3/mathics-threejs-backend>`_ (Graphics3D rendering using threejs)
+* `pymathics-natlang <https://github.com/Mathics3/pymathics-natlang>`_ (Natural Language Processing add-on)
+* `pymathics-graph <https://github.com/Mathics3/pymathics-graph>`_ (Graph add-on based on `NetworkX <https://networkx.org/>`_.
 
 It is likely that in the future more components will be added, so stay tuned...
 
@@ -42,7 +44,7 @@ Docker-specific items
 
 By default, we use a SQLite database that has examples that you can
 load and use. This data comes from
-[mathics-omnibus/django-db/mathics.sqlite](https://github.com/Mathics3/mathics-omnibus/tree/master/docker/django-db).
+`mathics-omnibus/django-db/mathics.sqlite <https://github.com/Mathics3/mathics-omnibus/tree/master/docker/django-db>`_.
 
 Since this is tied to the docker image, any changes made won't survice
 across restarting the docker image.