Clear distinguish between List and Array

[gnudles]

By reading the docs, it is not clear what is the difference between array and list. And the syntax of creating array is not introduced ([>1,2]). So please make it easy to understand in the docs.

[phated]

Hey @gnudles - We generally open website/documentation issues at https://github.com/grain-lang/grain-lang.org

I'll transfer this for you. Additionally, documentation work usually falls pretty low on our priority list compared to building the actual language, tooling and compiler.

[gnudles]

"Documenting your code helps you find bugs in your design."

[phated]

Please don't come into the project out of the blue and lecture the authors on how to spend their time. I assure you we discuss allocation amongst the team.

[gnudles]

I didn't mean to offend you Sir, nor to lecture anybody. I'm sorry if it sounded like that. I just wanted to make a point that documenting is not only for the sake of new comers, but it also helps the developer. It is sort of rubber-duck debug. Have a nice day Sir, keep smiling :) we all have good intentions...

[phated]

No worries, internet conversation is hard. We're actually going to be rolling out a new documentation generator that should alleviate some of this pressure for the stdlib and then maybe we can find some more time for the guides.