Update README.rst

Additional improvements, fixes and remove outdated files.

Change-Id: I71cff539bb0ad32899791d658d2cf8cdef473886

README.rst

@@ -4,81 +4,44 @@ Skyline (OpenStack Modern Dashboard)
 
 Skyline Console is a modern dashboard for OpenStack - UI.
 
--  `Documentation <https://docs.openstack.org/skyline-console/latest/index.html>`__
+* Project documentation: https://docs.openstack.org/skyline-console/latest/
--  `Installing Guide <https://docs.openstack.org/skyline-console/latest/install/index.html>`__
+* Release management: https://launchpad.net/skyline-console
--  `Issue tracking: <https://launchpad.net/skyline-console>`__
+* Installing Guide: https://docs.openstack.org/skyline-console/latest/install/
--  `Release notes: <https://docs.openstack.org/releasenotes/skyline-console/>`__
+* Issue tracking: https://launchpad.net/skyline-console
--  `Wiki <https://wiki.openstack.org/wiki/Skyline>`__
+* Release notes: https://docs.openstack.org/releasenotes/skyline-console/
+* Wiki: https://wiki.openstack.org/wiki/Skyline
 
 .. image:: https://governance.openstack.org/tc/badges/skyline-console.svg
     :target: https://governance.openstack.org/tc/reference/tags/
 
-Instructions
-------------
-
-`简体中文 <./README/README-zh_CN.rst>`__ \| English \| `한국어 <./README/README-ko_KR.rst>`__
-
-**Table of contents**
-
--  `Instructions <#instructions>`__
-
-   -  `Using Skyline <#usingskyline>`__
-   -  `Docs <#docs>`__
-
-      -  `How to develop <#how-to-develop>`__
-      -  `How to test <#how-to-test>`__
-
 Using Skyline
--------------
+=============
 
-See doc/source/install/index.rst about how to install Skyline in your OpenStack setup. It describes the example steps and has pointers for more detailed settings and configurations.
+See ``doc/source/install/index.rst`` about how to install Skyline in your OpenStack setup. It describes the example steps and has pointers for more detailed settings and configurations.
 
-It is also available at `Installing Guide <https://docs.openstack.org/skyline-console/latest/install/index.html>`__.
+It is also available at `Installing Guide <https://docs.openstack.org/skyline-console/latest/install/>`__.
 
-Docs
+Getting Started for Developers
-----
+==============================
 
-How to develop
+`Development Guide <https://docs.openstack.org/skyline-console/latest/development/>`_
-~~~~~~~~~~~~~~
+describes how to setup Skyline development environment and start development.
 
--  `Preparation before
+Building Contributor Documentation
-   development <docs/en/develop/1-ready-to-work.md>`__
+==================================
--  `Directory structure <docs/en/develop/2-catalog-introduction.md>`__
--  `Develop a new resource
-   page <docs/en/develop/3-0-how-to-develop.md>`__
--  `BaseList
-   introduction <docs/en/develop/3-1-BaseList-introduction.md>`__
--  `BaseTabList
-   introduction <docs/en/develop/3-2-BaseTabList-introduction.md>`__
--  `BaseDetail
-   introduction <docs/en/develop/3-3-BaseDetail-introduction.md>`__
--  `BaseDetailInfo
-   introduction <docs/en/develop/3-4-BaseDetailInfo-introduction.md>`__
--  `BaseStore
-   introduction <docs/en/develop/3-5-BaseStore-introduction.md>`__
--  `FormAction
-   introduction <docs/en/develop/3-6-FormAction-introduction.md>`__
--  `ModalAction
-   introduction <docs/en/develop/3-7-ModalAction-introduction.md>`__
--  `ConfirmAction
-   introduction <docs/en/develop/3-8-ConfirmAction-introduction.md>`__
--  `StepAction
-   introduction <docs/en/develop/3-9-StepAction-introduction.md>`__
--  `FormItem
-   introduction <docs/en/develop/3-10-FormItem-introduction.md>`__
--  `Action introduction <docs/en/develop/3-11-Action-introduction.md>`__
--  `Menu introduction <docs/en/develop/3-12-Menu-introduction.md>`__
--  `Route introduction <docs/en/develop/3-13-Route-introduction.md>`__
--  `I18n introduction <docs/en/develop/3-14-I18n-introduction.md>`__
 
-How to test
+This documentation is written by contributors, for contributors.
-~~~~~~~~~~~
 
--  `Two kinds of tests <docs/en/test/1-ready-to-work.md>`__
+The source is maintained in the ``doc/source`` directory using
--  `Directory structure <docs/en/test/2-catalog-introduction.md>`__
+`reStructuredText`_ and built by `Sphinx`_
--  `How to edit e2e case <docs/en/test/3-0-how-to-edit-e2e-case.md>`__
+
--  `E2E - Form operation <docs/en/test/3-1-E2E-form-operation.md>`__
+.. _reStructuredText: https://docutils.sourceforge.net/rst.html
--  `E2E - Table operation <docs/en/test/3-2-E2E-table-operation.md>`__
+.. _Sphinx: https://sphinx-doc.org/
--  `E2E - Detail operation <docs/en/test/3-3-E2E-detail-operation.md>`__
+
--  `E2E - Resource
+Some of the diagrams are generated using the ``dot`` language
-   operation <docs/en/test/3-4-E2E-resource-operation.md>`__
+  from Graphviz. See the `Graphviz documentation <https://www.graphviz.org/>`_
+  for Graphviz and dot language usage information.
+
+To build the docs, use::
+
+  $ tox -e docs

doc/README.rst

@@ -1,33 +0,0 @@
-================================
-Skyline Console Development Docs
-================================
-
-Files under this directory tree are used for generating the documentation
-for the skyline-console source code.
-
-Developer documentation is built to:
-https://docs.openstack.org/skyline-console/latest/
-
-Tools
-=====
-
-Sphinx
-  The Python Sphinx package is used to generate the documentation output.
-  Information on Sphinx, including formatting information for RST source
-  files, can be found in the `Sphinx online documentation
-  <http://www.sphinx-doc.org/en/stable/>`_.
-
-Graphviz
-  Some of the diagrams are generated using the ``dot`` language
-  from Graphviz. See the `Graphviz documentation <http://www.graphviz.org/>`_
-  for Graphviz and dot language usage information.
-
-
-Building Documentation
-======================
-
-Doc builds are performed using tox with the ``docs`` target::
-
- % cd ..
- % tox -e docs
-