diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7717ca6..5ad1ec2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,31 @@
 stlink ChangeLog
 ================
 
+v1.6.2
+======
+
+Release date: (TBD)
+
+Features:
+
+Updates & changes:
+
+* [doc] st-flash --reset parameter (one solution for #356) ([#642](https://github.com/stlink-org/stlink/pull/642))
+* [refactoring] General maintenance ([#864](https://github.com/stlink-org/stlink/pull/864), [#976](https://github.com/stlink-org/stlink/pull/976), [#978](https://github.com/stlink-org/stlink/pull/978))
+* Imported debian pkg-settings ([#986](https://github.com/stlink-org/stlink/pull/986))
+* Add support for FreeBSD's libusb reimplementation ([#992](https://github.com/stlink-org/stlink/pull/992), [#993](https://github.com/stlink-org/stlink/pull/993))
+
+Fixes:
+
+* [regression] Changed timeout on flash write ([#787](https://github.com/stlink-org/stlink/pull/787), [#981](https://github.com/stlink-org/stlink/pull/981), [#987](https://github.com/stlink-org/stlink/pull/987))
+* cmake compile failure with external CMAKE_MODULE_PATH set ([#962](https://github.com/stlink-org/stlink/pull/962))
+* doc/man: Fixed installation directory ([#970](https://github.com/stlink-org/stlink/pull/970))
+* Fixed installation path for desktop-file and icons ([#972](https://github.com/stlink-org/stlink/pull/972))
+* Fix for static linking of libssp ([#973](https://github.com/stlink-org/stlink/pull/973), [#974](https://github.com/stlink-org/stlink/pull/974))
+* Fixed connect under reset for st-flash and st-util ([#983](https://github.com/stlink-org/stlink/pull/983))
+* Fix for mmap() size_t overflow in st-flash ([#988](https://github.com/stlink-org/stlink/pull/988), [#989](https://github.com/stlink-org/stlink/pull/989))
+
+
 v1.6.1
 ======
 
@@ -139,7 +164,7 @@ Updates and fixes:
 * Fixed relative path to the UI files needed by stlink-gui-local (GUI) ([#770](https://github.com/stlink-org/stlink/pull/770), [#771](https://github.com/stlink-org/stlink/pull/771))
 * Added howto for sending NRST signal through GDB ([#774](https://github.com/stlink-org/stlink/pull/774), [#776](https://github.com/stlink-org/stlink/pull/776), [#779](https://github.com/stlink-org/stlink/pull/779))
 * Fixed package name "devscripts" in doc/compiling.md ([#775](https://github.com/stlink-org/stlink/pull/775))
-* Fixed few potential memory/resource leaks ([#803](https://github.com/stlink-org/stlink/pull/803))
+* Fixed few potential memory/resource leaks ([#803](https://github.com/stlink-org/stlink/pull/803), [#831](https://github.com/stlink-org/stlink/pull/831))
 * Updated Linux source repositories in README.md: Debian and Ubuntu ([#821](https://github.com/stlink-org/stlink/pull/821), [#835](https://github.com/stlink-org/stlink/pull/835), [#859](https://github.com/stlink-org/stlink/pull/859))
 * Do not issue JTAG reset on stlink-v1 ([#828](https://github.com/stlink-org/stlink/pull/828))
 * Fixed flash size of STM32 Discovery vl ([#829](https://github.com/stlink-org/stlink/pull/829))
diff --git a/README.md b/README.md
index 21ab9f4..5be8421 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@ The stlink library and tools are licensed under the **[BSD-3 License](LICENSE.md
 STLink is an open source toolset to program and debug STM32 devices and boards manufactured by STMicroelectronics.
 It supports several so called STLINK programmer boards (and clones thereof) which use a microcontroller chip to translate commands from USB to JTAG/SWD. There are four generations available on the market which are _all_ supported by this toolset:
 
-* **STLINK/v1** _(obsolete as of 21-11-2019)_
+* **STLINK/v1** _(obsolete as of 21-11-2019, continued support by this toolset)_
   - transport layer: SCSI passthru commands over USB
   - stand-alone programmer and present on STM32VL Discovery boards
 * **STLINK/v2**
@@ -83,8 +83,10 @@ Alternatively one can compile and install from source as described in our [compi
 
 We recommend to install `stlink-tools` from the package repository of the used distribution:
 
-* Debian Linux: [(Link)](https://packages.debian.org/buster/stlink-tools)
-* Ubuntu Linux: [(Link)](https://packages.ubuntu.com/stlink-tools)
+**Note:** As packages distributed via the [Debian](https://packages.debian.org/buster/stlink-tools) and [Ubuntu](https://packages.ubuntu.com/stlink-tools) repositories differ from our self-maintained deb-package, we recommend to use the latter instead (see link below). It provides the opportunity to handle and fix user-reported package issues directly within the project and is not redundant to any limitations deriving from external maintenance guidelines.
+
+* Debian Linux: [(Link)](https://github.com/stlink-org/stlink/releases)
+* Ubuntu Linux: [(Link)](https://github.com/stlink-org/stlink/releases)
 * Arch Linux:   [(Link)](https://www.archlinux.org/packages/community/x86_64/stlink)
 * Alpine Linux: [(Link)](https://pkgs.alpinelinux.org/packages?name=stlink)
 * Fedora:       [(Link)](https://src.fedoraproject.org/rpms/stlink)