More documentation, mainly join the community section.

Signed-off-by: Antonio Jesus Navarro Perez <[email protected]>

Author: ajnavarro

README.md

@@ -22,8 +22,16 @@ For more info about how to use it, see the [docs](/docs).
 
 ## Motivation and scope
 
+gitbase was born to make easier the task of analyze git repositories and source code contained on them.
+
+Also, making it MySQL compatible, we want the maximum compatibility between languages and existing tools.
+
+Having that running on a simple binary allow us to use as a stand-alone service able to process some local repositories, or integrate it with other existing tools and frameworks like Spark to make large-scale source code analysis.
+
 ## Further reading
 
+From here, you can directly go to [getting started](/docs/using-gitbase/getting-started.md).
+
 ## License
 
 Apache License Version 2.0, see [LICENSE](LICENSE)

docs/join-the-community.md

@@ -2,6 +2,18 @@
 
 ## Chat
 
+If you need support, want to contribute or just want to say hi, join us at the [source{d} community Slack](https://join.slack.com/t/sourced-community/shared_invite/enQtMjc4Njk5MzEyNzM2LTFjNzY4NjEwZGEwMzRiNTM4MzRlMzQ4MmIzZjkwZmZlM2NjODUxZmJjNDI1OTcxNDAyMmZlNmFjODZlNTg0YWM). We hang out in the #general channel.
+
 ## Contributing
 
-## Reporting bugs
+You can start contributing in many ways
+
+* [Reporting bugs.](/docs/join-the-community.md#reporting-bugs)
+* [Request a feature.](https://github.com/src-d/gitbase/issues)
+* Improve the [documentation](https://github.com/src-d/gitbase/docs).
+* Contribute code to [gitbase](https://github.com/src-d/gitbase),
+* Write a new data source using [go-mysql-server](https://github.com/src-d/go-mysql-server)
+
+## Reporting bugs
+
+Bugs should be reported through [GitHub Issues](https://github.com/src-d/gitbase/issues).

docs/using-gitbase/getting-started.md

@@ -37,6 +37,21 @@ make dependencies
 
 ## Running with docker
 
+You can use the official image from [docker hub](https://hub.docker.com/r/srcd/gitbase/tags/) to quickly run gitbase:
+```
+docker run --rm --name gitbase -p 3306:3306 -v /my/git/repos:/opt/repos srcd/gitbase:latest
+```
+
+If you want to speedup gitbase using indexes, you must run a pilosa container:
+```
+docker run -it --rm --name pilosa -p 10101:10101 pilosa/pilosa:v0.9.0
+```
+
+Then link the gitbase container to the pilosa one:
+```
+docker run --rm --name gitbase -p 3306:3306 --link pilosa:pilosa -e PILOSA_ENDPOINT="http://pilosa:10101" -v /my/git/repos:/opt/repos srcd/gitbase:latest
+```
+
 ## Connecting to the server
 
 When the server is started,a MySQL client is needed to connect to the server. For example: