Hacker News new | ask | show | jobs
by randomThoughts9 3889 days ago
I hope they'll redo some of the documentation with this upcoming release. Every time I read it, I am amazed by how comprehensive it is but still manages to miss some very important points.

Like the fact that on the main page, the link to the online editor is not under the "Try it out" section. The explore action from that section is also misleading.

Or a clean hello world, with a real project structure documented

Or the way collections are documented. Basically, you have section 6 from the tour of ceylon: Streams, sequences and tuples. But it's not obvious what is the big difference between streams and sequences and the fact that sequences borrow the array notation while being immutable doesn't help either. Even when you go to the List api, which is the interface any Java developer will look for,you can't find the mutable collections, because they live in another module.

1 comments

Would you please open an issue here with the things you would like changed:

https://github.com/ceylon/ceylon-lang.org/issues

Thanks.