diff --git a/README.md b/README.md
index 47d3e5948..f6739a7d7 100644
--- a/README.md
+++ b/README.md
@@ -7,23 +7,28 @@
 
 <hr />
 
-[![codecov](https://codecov.io/gh/nspcc-dev/neo-go/branch/master/graph/badge.svg)](https://codecov.io/gh/nspcc-dev/neo-go)
-[![CircleCI](https://circleci.com/gh/nspcc-dev/neo-go/tree/master.svg?style=svg)](https://circleci.com/gh/nspcc-dev/neo-go/tree/master)
-[![Report](https://goreportcard.com/badge/github.com/nspcc-dev/neo-go)](https://goreportcard.com/report/github.com/nspcc-dev/neo-go)
-[![GoDoc](https://godoc.org/github.com/nspcc-dev/neo-go?status.svg)](https://godoc.org/github.com/nspcc-dev/neo-go)
+[![codecov](https://codecov.io/gh/nspcc-dev/neo-go/branch/master-2.x/graph/badge.svg)](https://codecov.io/gh/nspcc-dev/neo-go/branch/master-2.x)
+[![CircleCI](https://circleci.com/gh/nspcc-dev/neo-go/tree/master-2.x.svg?style=svg)](https://circleci.com/gh/nspcc-dev/neo-go/tree/master-2.x)
 ![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/nspcc-dev/neo-go?sort=semver)
 ![License](https://img.shields.io/github/license/nspcc-dev/neo-go.svg?style=popout)
 
 # Overview
 
-This project aims to be a full port of the original C# [NEO project](https://github.com/neo-project).
+This project aims to be a full port of the original C# [Neo project](https://github.com/neo-project).
 A complete toolkit for the NEO blockchain, including:
 
 - [Consensus node](docs/consensus.md)
-- [RPC node & client](https://github.com/nspcc-dev/neo-go/tree/master/docs/rpc.md)
-- [CLI tool](https://github.com/nspcc-dev/neo-go/blob/master/docs/cli.md)
-- [Smart contract compiler](https://github.com/nspcc-dev/neo-go/blob/master/docs/compiler.md)
-- [NEO virtual machine](https://github.com/nspcc-dev/neo-go/blob/master/docs/vm.md)
+- [RPC node & client](docs/rpc.md)
+- [CLI tool](docs/cli.md)
+- [Smart contract compiler](docs/compiler.md)
+- [NEO virtual machine](docs/vm.md)
+
+This branch (**master-2.x**) is a stable version of the project compatible
+with Neo 2, it only receives bug fixes and minor updates. For the Neo 3
+development version please refer to the [**master**
+branch](https://github.com/nspcc-dev/neo-go/tree/master) and releases
+after 0.90.0. Releases before 0.80.0 (**0.7X.Y** track) are made from this
+branch and only contain Neo 2 code.
 
 # Getting started
 
@@ -101,7 +106,7 @@ where you can switch on/off and define port. Prometheus is enabled and Pprof is
 # Contributing
 
 Feel free to contribute to this project after reading the
-[contributing guidelines](https://github.com/nspcc-dev/neo-go/blob/master/CONTRIBUTING.md).
+[contributing guidelines](CONTRIBUTING.md).
 
 Before starting to work on a certain topic, create an new issue first,
 describing the feature/topic you are going to implement.
@@ -114,4 +119,4 @@ describing the feature/topic you are going to implement.
 
 # License
 
-- Open-source [MIT](https://github.com/nspcc-dev/neo-go/blob/master/LICENSE.md)
+- Open-source [MIT](LICENSE.md)
diff --git a/docs/cli.md b/docs/cli.md
index adcbf0dbc..8a80d2b04 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -166,7 +166,7 @@ INDEX    OPCODE    DESC
 ```
 
 In depth documentation about the **neo-go** compiler and smart contract examples can be found inside 
-the [compiler package](https://github.com/nspcc-dev/neo-go/tree/master/pkg/compiler).
+the [compiler package](pkg/compiler).
 
 ## VM run
 To run VM use
diff --git a/docs/compiler.md b/docs/compiler.md
index 3887028d9..a7e59652c 100644
--- a/docs/compiler.md
+++ b/docs/compiler.md
@@ -138,7 +138,7 @@ At the moment this is implemented via RPC call to the remote server.
 
 ## Smart contract examples
 
-Some examples are provided in the [examples directory](https://github.com/nspcc-dev/neo-go/tree/master/examples).
+Some examples are provided in the [examples directory](examples).
 
 ### Check if the invoker of the contract is the owning address