Spinoco / fs2-cassandra

Asynchronous, fully functional Cassandra driver implemented in fs2
https://spinoco.github.io/fs2-cassandra/
MIT License
18 stars 8 forks source link

[docs] - Materialized View Builder #14

Open gvolpe opened 5 years ago

gvolpe commented 5 years ago

Motivation

This project is awesome but IMO super underrated so I want to change that. And in order to do so I'm calling out all the awesome OSS developers out in the community to make a first contribution!

Getting Started

All you need is to fork this repo, pick one issue (please announce it in the corresponding Github issue to avoid duplicated work) and create a Pull Request once you're done.

The documentation is compiled using tut. You can see whether your work compiles or not by running the following commands:

> sbt 
> project microsite
> makeMicrosite

This will run tut and if it compiles it will generate the static HTML / CSS / JS files. To have a local preview of the microsite you need to access the directory $PROJECT/site/target/site and run jekyll serve.

If you don't have it yet you will need to install jekyll, it's fairly easy :smiley:

Writing Documentation

For references you can take a look at the Query Builder docs. It was basically documented by looking at the unit tests defined here.

The procedure with Materialized View Builder should be very similar. Look at the unit tests here and at the structure of the tables defined here.

Should you need any help please reach out on the Gitter channel, thanks for contributing! :smiley: