scicloj / tutorials

A repo for hosting Clojure data science tutorials created by the community
15 stars 7 forks source link

Scicloj Tutorials

In this repo is a place for Clojure data science tutorials created by the community.

It is part of Scicloj -- our community effort to create more dialogue and coordination among Clojurians creating open source solutions for data science.

Tutorials will also appear at the Scicloj website.

Contributing

You are invited to contribute. Please contact us if you wish to.

For the tutorials you write, you can use Jupyter, plain Clojure code, Org-mode, etc.

Guidelines and organization of this repo

Soon we will design a more refined directory structure, to reflect different topics, kaggle competetions, etc.

For now, please put your tutorials under the drafts subdirectory.

Please do not put data files in git. It is better to add a function or script for bringing them locally.

Please mention your (nick)name(s) at the beginning of any repo you write.

A tutorial's lifecycle

We distinguish between two kinds of tutorials:

By default, tutorials are experimental. An tutorial's author can ask to mark it as recommended. To agree on that, at least 2 of the group members will have to read it and feel that is fine.

Usage

Jupyter

Lein Jupyter

TBD

Plain Clojure

Everything here is under one Leiningen project. This should be fine for most use cases. If, for some reason, you need to create a separate project (e.g., using a different Clojure version), then please do so under a subdirectory.

Org-mode

TBD

Contact

The proper place to discuss this is the #data-science stream at the clojurians-zulipchat.

You can find past discussions at the #scicloj-tutorials stream.

Here is some general info about our the Scicloj chat streams.

License

Copyright © 2019 Scicloj

Distributed under the Eclipse Public License.