RELEASING.rst, doc: show release notes in manual

RELEASES

@@ -1,25 +0,0 @@
-Release process
-===============
-
-Maintain the release notes in this file with a list of new features and API changes in each major release.
-
-Major releases:
-1. Create branch release-X from master.
-2. Remove any unfinished features.
-3. Test and fix any problems found.
-4. Tag X.0.
-
-Minor (bugfix) releases:
-1. Backport bugfixes from the master branch or fix bugs specific to old releases into the currently maintained release-X branch(es).
-2. When significant bugs have been fixed, tag X.Y+1.
-3. To help dealing with regressions, no new features or refactorings should be implemented in release-X branches. Those happen in the master branch, and then a new release-X+1 branch is created.
-
-
-Release notes
-=============
-
-1.0
----
-* First release
-* Experiments (your code) should use ``from artiq.experiment import *``
-  (and not ``from artiq import *`` as previously)

RELEASE_NOTES.rst

@@ -0,0 +1,9 @@
+Release notes
+=============
+
+1.0
+---
+
+  * First release
+  * Experiments (your code) should use ``from artiq.experiment import *``
+    (and not ``from artiq import *`` as previously)

RELEASING.rst

@@ -0,0 +1,17 @@
+Release process
+===============
+
+Maintain ``RELEASE_NOTES.rst`` with a list of new features and API changes in each major release.
+
+Major releases:
+
+  1. Create branch release-X from master.
+  2. Remove any unfinished features.
+  3. Test and fix any problems found.
+  4. Tag X.0.
+
+Minor (bugfix) releases:
+
+  1. Backport bugfixes from the master branch or fix bugs specific to old releases into the currently maintained release-X branch(es).
+  2. When significant bugs have been fixed, tag X.Y+1.
+  3. To help dealing with regressions, no new features or refactorings should be implemented in release-X branches. Those happen in the master branch, and then a new release-X+1 branch is created.

doc/manual/index.rst

@@ -8,6 +8,7 @@ Contents:
 
     introduction
     installing
+    release_notes
     getting_started_core
     getting_started_mgmt
     core_device

doc/manual/introduction.rst

@@ -4,6 +4,7 @@ Introduction
 .. this does not work because of relative paths for the logo:
    .. include:: ../../README.rst
    and including in README.rst does not work on github
+   therefore just keep this content synchronized with README.rst
 
 ARTIQ (Advanced Real-Time Infrastructure for Quantum physics) is a
 next-generation control system for quantum information experiments. It is

doc/manual/release_notes.rst

@@ -0,0 +1 @@
+.. include:: ../../RELEASE_NOTES.rst