more docs

Author: lfagundes

README.rst

@@ -20,25 +20,14 @@ Solid Node
 
 
 
-A framework to create parametrical mechanical projects with Free Software
-
+**The Free Software framework for parametric 3D printable mechanical projects**
 
 * Free software: GNU Affero General Public License v3
 * Documentation: https://solid-node.readthedocs.io.
 
-Introduction
-============
-
-There are several technologies that allow the creation of parametric solids
-using Free Software, namely OpenScad, CadQuery and Solid Python. When it comes
-to mechanical projects, each technology has a different set of libraries available,
-and each has its pros and cons. Whichever your choice, they all face limitations
-soon. Solid Node proposes an architecture to organize mechanical projects so that
-different technologies can be combined, relation between components can be tested,
-and individual pieces can be rendered for optimization.
-
 Quickstart
 ==========
 
-Start by cloning `solid-seed <https://github.com/LibreSolid/solid-seed>_`.
-Follow instructions from the README file there.
+Start by cloning `solid-seed <https://github.com/LibreSolid/solid-seed>`_.
+
+See `the docs <https://solid-node.readthedocs.io`_.

docs/contributing.rst

@@ -0,0 +1,9 @@
+
+.. _contributing:
+
+============
+Contributing
+============
+
+
+Issues, PRs and discussions can be posted at the project's `Github page <https://github.com/LibreSolid/solid-node>`_

docs/index.rst

@@ -8,3 +8,5 @@ Solid Node documentation
    why-solid-node
    quickstart
    using-solid-node
+   status-and-roadmap
+   contributing

docs/status-and-roadmap.rst

@@ -0,0 +1,16 @@
+
+.. _status-and-roadmap:
+
+==============
+Project status
+==============
+
+This project has been developed and maintained by a single person so far, and as it is, it's pretty usable. It can already solve real bottlenecks in mechanical project development. It's still a bit far from 1.0 version, but the **current node API should not change** until there.
+
+Roadmap
+=======
+
+  * Improve the web viewer with workplanes, rulers, camera angles, animation control, etc
+  * A "dist" command that packs the project into a distributable with source and builds
+  * A "publish" command that creates a static website with docstrings, viewer, source and build downloads
+  * Separate the watcher and builder internal processes to recover from errors