Merge branch 'master' into ci

Author: Guillem Duran

license.md LICENSE.mdlicense.md renamed to LICENSE.md

@@ -1,7 +1,23 @@
 # MLonCode Core Library
- [![Build Status](https://travis-ci.org/src-d/ml-core.svg)](https://travis-ci.org/src-d/ml-core)
- [![codecov](https://codecov.io/github/src-d/ml-core/coverage.svg)](https://codecov.io/gh/src-d/ml-core)
- [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
+ [![Travis build status](https://travis-ci.com/src-d/ml-core.svg)](https://travis-ci.com/src-d/ml-core)
+ [![Code coverage](https://codecov.io/github/src-d/ml-core/coverage.svg)](https://codecov.io/github/src-d/ml-core)
+ [![Read the Docs](https://img.shields.io/readthedocs/ml-core.svg)](https://readthedocs.org/projects/ml-core/)
+[![Docker build status](https://img.shields.io/docker/build/srcd/ml-corer.svg)](https://hub.docker.com/r/srcd/ml-core)
+[![PyPi package status](https://img.shields.io/pypi/v/srcd-ml-core.svg)](https://pypi.python.org/pypi/srcd-ml-core)
+![stability: alpha](https://svg-badge.appspot.com/badge/stability/alpha?color=f47142)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-Library for machine learning on source code. Provides commonly used algorithms and tools
- to process the code-related data, such as: Babelfish's UASTs, plain code text, etc.
+This library is the foundation for [MLonCode](https://github.com/src-d/awesome-machine-learning-on-source-code) research and development. 
+It contains commonly used algorithms and tools to process the code-related data, such as [Babelfish's UASTs](docs.sourced.tech/babelfish), plain code text and other.
+
+## Contributions
+
+...are welcome! See [CONTRIBUTING.md](docs/CONTRIBUTING.md) and [CODE\_OF\_CONDUCT.md](docs/CODE_OF_CONDUCT.md).
+
+## License
+
+[Apache 2.0](LICENSE.md)
+
+## Glossary
+
+See [here](docs/GLOSSARY.md).

maintainers.md MAINTAINERS.mdmaintainers.md renamed to MAINTAINERS.md

@@ -1,6 +1,6 @@
 # CONTRIBUTING
 
-ml-core project is [Apache licensed](license.md) and accepts contributions via GitHub pull 
+ml-core project is [Apache licensed](LICENSE.md) and accepts contributions via GitHub pull 
 requests. This document outlines some of the conventions on development workflow, commit message formatting, contact points, and other resources to make it easier to get your contribution accepted.
 
 ## Certificate of Origin
@@ -15,7 +15,7 @@ This can be done easily using the [`-s`](https://github.com/git/git/blob/b2c150d
 
 The official support channels, for both users and contributors, are:
 
-* GitHub [issues](https://github.com/src-d/ml/issues)\*
+* GitHub [issues](https://github.com/src-d/ml-core/issues)\*
 * Slack: \#machine-learning room in the [source{d} Slack](https://join.slack.com/t/sourced-community/shared_invite/enQtMjc4Njk5MzEyNzM2LTFjNzY4NjEwZGEwMzRiNTM4MzRlMzQ4MmIzZjkwZmZlM2NjODUxZmJjNDI1OTcxNDAyMmZlNmFjODZlNTg0YWM)
 
 \*Before opening a new issue or submitting a new pull request, it's helpful to search the project - it's likely that another user has already reported the issue you're facing, or it's a known issue that we're already aware of.
@@ -29,7 +29,7 @@ Pull Requests \(PRs\) are the main and exclusive way to contribute to the offici
 * The code is formatted according to [![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/).
 * If the PR is a bug fix, it has to include a new unit test that fails before the patch is merged.
 * If the PR is a new feature, it has to come with a suite of unit tests, that tests the new functionality.
-* In any case, all the PRs have to pass the personal evaluation of at least one of the [maintainers](maintainers.md).
+* In any case, all the PRs have to pass the personal evaluation of at least one of the [maintainers](MAINTAINERS.md).
 
 ### Format of the commit message
 

README.md

@@ -0,0 +1,8 @@
+# Table of contents
+
+* [README](README.md)
+* [LICENSE](LICENSE.md)
+* [MAINTAINERS](MAINTAINERS.md)
+* [CODE\_OF\_CONDUCT](docs/CODE_OF_CONDUCT.md)
+* [CONTRIBUTING](docs/CONTRIBUTING.md)
+