Read & analyze Key Concepts for new user

[joshhus]

Read & analyze Key Concepts for UX / new user. Per request by @denyeart.

https://hyperledger-fabric.readthedocs.io/en/latest/key_concepts.html

[joshhus]

Landing page (https://hyperledger-fabric.readthedocs.io/en/latest/key_concepts.html) - Add sub-headings to this list that clarify Who and What each Key Concept is for. Because not all concepts are for the same role and / goals, presumably. (Note one person may play multiple roles for an org., still okay to split them up.)

For example:

Key Concepts ... For Developers >>

... For System/Blockchain Admins >>

... For Business Admins >>

[joshhus]

Key Concepts >> Introduction https://hyperledger-fabric.readthedocs.io/en/latest/blockchain.html

1. Not mentioning "blockchain" in the first paragraph is odd, esp. considering we then spring that on them in the next paragraph. It also reads a bit like a "word salad" (lots of big words, hard to interpret the point) which is a tough start for a new user. A simple bulleted list of what HLF is may be a clearer alternative.
2. I'm expecting a "Why blockchain" (also in addition to What) - we'll see if it's here on this page. TBA.
3. Kind of odd this diagram starts at the end and ends at the start, but perhaps there's an argument to be made.
4. The "encapsulating information and keeping it simple" description of smart contracts should be clarified as similar to "encapsulating agreed-upon business rules - and encoding them in logic called chaincode."
5. Can the TOC go another level deep? e.g. in What is blockchain DL, smart contracts, and consensus are not in TOC.

[joshhus]

Moving this to a Box document. ok?

[AliakbarETH]

@joshhus I believe you are right from the users perspective.

But ultimately we need to think from a developers mindset.

We can't classify the content based on the role but what we can do is to give him an extensive playground to play around.

So, he knows and goes through the most of the doc and understands the crux.

Honestly, Blockchain is generally not easy and hyperledger is a tough thing to go with so, I think that we need to keep it like that.