[vijayr]

We are internally always debating what does an user should known by default, and how

As a user, I'd like to read documentation that assumes I know nothing and tells me everything. OR, make a list at the beginning "these are the things that you need to know, to proceed". Some people might get offended if the documentation is too basic, but the majority will just skip those parts that they already know. Lengthy documentation is better than incomplete (or wrong) documentation, IMHO.