elixir-lang/elixir-lang.github.com

IO and the file system

rhcarvalho opened this issue · 3 comments

The second paragraph in Getting Started: IO and the file system reads:

We had originally sketched this chapter to come much earlier in the getting started guide. However, we noticed the IO system provides a great opportunity to shed some light on some philosophies and curiosities of Elixir and the VM.

I have the impression what was meant was much later instead of much earlier, as otherwise the contrast with "however" sounds weird. The overall sentence gives me the intuition that this section comes now instead of later to teach me something worthwhile.

Could someone confirm or reject my reasoning? I could send a patch in the positive case.

It is meant to be written as is. We want to use the chapter on IO to explore more complex topics, so it comes later. But, nowadays, I think we can just remove this sentence anyway.

Thanks @josevalim! Reading again I understood it: originally it would have come earlier, but it's been "delayed" because it has more advanced ideas that wouldn't fit well much earlier in the guide.

If you want to send a PR either removing or improving it, it will be welcome. :) Your call!