Extending release notes in preparation to 1.0.0

Author: sio

RELEASES.md

@@ -4,17 +4,39 @@ LibPQ is a library for importing Power Query M language source files from local
 and/or web storage. The project follows [semantic versioning](https://semver.org/)
 specification.
 
-This document describes the changes between releases of LibPQ.
+This document describes the changes between releases of LibPQ. [Keeping a
+changelog](http://keepachangelog.com) is important!
 
 <!--
 ## Unreleased changes (currently in git `master`)
 -->
 
 ## Version 1.0.0 (2018-02-#N/A)
 
-`Commit: master`
+#### Git commit: `#n/a`
 
 This is the first release of LibPQ. The library and the loader are considered
 feature full and stable.
 
-// TODO: complete this stub
+Most of the features are described in the [README](README.md) and in
+[documentation][docs]. Introductory overview is available at [author's
+blog][intro].
+
+
+#### New features
+- Import source code from plain text files located on disk or on the web
+- Unlimited number of import locations ordered by priority
+- [Unit testing][unittesting] framework
+- Show [docstrings] in Power Query user interface
+- A collection of general purpose [functions and queries][modules]
+- Compatibility with [@tycho01's library][tycho01]
+
+[docs]: Docs/README.md
+[docstrings]: Docs/Docstrings.md
+[intro]: https://potyarkin.ml/posts/2018/expanding-power-query-standard-library-introducing-libpq/
+[modules]: Docs/Modules.md
+[tycho01]: https://github.com/tycho01/pquery
+[unittesting]: Docs/UnitTesting.md
+
+
+// TODO: update this stub with actual release date and commit hash

ROADMAP.md

@@ -14,8 +14,8 @@ Current goals and values (in order of descending importance) are:
   use, and we should not interfere with the code they've built upon ours. This
   applies most strictly to the loader and the modules essential for internal
   use (e.g. UnitTest framework), other modules may see some breaking changes in
-  future (that must always be documented in [release notes] and must be reflected
-  in the release [version number][SemVer]).
+  future (that must always be documented in [release notes](RELEASES.md) and
+  must be reflected in the release [version number](https://semver.org/)).
 - **Improving import-time user experience**. LibPQ already offers local module
   listing, parses module docstrings for viewing in the UI and correctly relays
   errors in modules' code, but there must be other methods to improve module
@@ -34,23 +34,3 @@ Current goals and values (in order of descending importance) are:
 ## Release 1.0 roadmap
 - Fix issue #7
 - Add release notes (markdown file, in root directory)
-    - File name: RELEASES or CHANGELOG?
-    - Keep release dates
-    - Link git commit range
-    - Newest releases on top of the file, [Unreleased] section for changes
-      after the last release
-    - Add a short description on top
-        - Mention that the project follows semantic versioning https://semver.org/
-        - Link to http://keepachangelog.com
-    - Structured description
-    - Release notes sections:
-        - Added (features and improvements)
-        - Changed
-        - Deprecated
-        - Removed
-        - Fixed
-        - Security
-
-
-[SemVer]: https://semver.org/
-[release notes]: RELEASES.md