Elomar, what are you planning on doing with this book that previous authors have not? If you’re going to spend the time writing this book, you’ll want to give the community something they don’t already have.
jeramyRR
NobbZ
I strictly prefer emacs’ org-mode over all of them, but as most – if not all – renderers only implement a subset of what is possible (and this is for a reason), I tend to use markdown, as most source hosting services have proper (or at least good-enough) rendering.
Also markdown is understood by most of our clients.
If though I had to choose for a personal/private project, I’d definitely use org-mode, exporting to HTML or LaTeX.
1
cmkarlsson
With sphinx (Sphinx — Sphinx documentation) you can have latex generation. We’ve used this for a couple of projects where we can customize the latex templates and have really nice documentation, but also have access to nice HTML and other formats.
0
thiagovarela
I think it is a good effort, he’ll bring his point of view, even if addressing problems covered by other authors. The way I see, the more learning resources Elixir has, the better.
1
outlog
re installation
I would suggest instructing people to use GitHub - asdf-vm/asdf: Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more · GitHub for the platforms supported (all except windows i think..) and perhaps show how to install and “lock” the elixir version with .tool-versions etc. also consider/suggest using it for the nodejs install.
1
eksperimental
I also agree in part with it, and I have seen most of the books covering the same topics at least in the beginning of the books.But the question is how many of those books are free?
That’s what sets this one apart from the rest.
1
elomarns
Sorry for the late answer, I have been pretty busy in the last few days.
Answering some of the questions:
-
The book is already on GitHub: GitHub - elomarns/100_pages_of_elixir: 100 page book about the basic concepts of Elixir. · GitHub. Sorry, I should have linked it on the original post.
-
I’m using Kitabu to write it. Kitabu is a great framework for writing technical books. It allows me to write the book on Markdown files, and it can export to
.pdf,.mobiand.epub. -
Due to some time-related problems, I couldn’t write too much on the last few days. But now I’m returning to it, and I believe I’ll finish chapter 2 tomorrow. I’ll post here as soon as I finish it
-
I know there are a lot of basic books about Elixir. And I won’t lie, 100 Pages of Elixir won’t have any content that most of the other basic books already don’t have. I believe the biggest difference is the approach: it’s a more focused book, with only 100 pages. It’s aimed at experienced developers who just want to jump in Elixir without having to read again about the most basic concepts.
-
I know 100 pages are not enough to cover Elixir as a whole, so I’m planning to write other books about it. For example, a book about concurrency (100 Pages of Concurrency with Elixir, or something like that).
Anyway, thank you all for your interest.
3