Merge pull request #3791 from xxh/master

The order of sections in docs changed 2

README.rst

@@ -25,7 +25,13 @@ xonsh is a Python-powered, cross-platform, Unix-gazing shell language and comman
 The language is a superset of Python 3.5+ with additional shell primitives.
 xonsh (pronounced *conch*) is meant for the daily use of experts and novices alike.
 
-Please visit https://xon.sh for more information.
+If you like the idea of xonsh click :star: on the repo and stay tuned by watching releases.
+
+Visit https://xon.sh for more information:
+
+- `Installation <https://xon.sh/contents.html#installation>`_ - using packages, docker or AppImage.
+- `Tutorial <https://xon.sh/tutorial.html>`_ - step by step introduction in xonsh.
+- `Xontribs <https://xon.sh/tutorial_xontrib.html>`_ - list of awesome xonsh extensions.
 
 Projects that use xonsh
 ***********************

docs/contents.rst

@@ -4,18 +4,16 @@ the xonsh shell
 
 .. include:: intro.rst
 
-.. include:: tryitnow.rst
-
-.. include:: comparison.rst
-
 .. include:: installation.rst
 
-.. include:: news.rst
+.. include:: comparison.rst
 
 .. include:: guides.rst
 
 .. include:: setup.rst
 
+.. include:: news.rst
+
 .. include:: contributing.rst
 
 .. include:: contact.rst

news/docs.rst

@@ -0,0 +1,23 @@
+**Added:**
+
+* <news item>
+
+**Changed:**
+
+* Changed sections order in docs
+
+**Deprecated:**
+
+* <news item>
+
+**Removed:**
+
+* <news item>
+
+**Fixed:**
+
+* <news item>
+
+**Security:**
+
+* <news item>