Providing the motivation and how to use this guide

[Can-Sahin]

This looks interesting but as I was going through the docs I had really hard time understanding what this repository is about. The Goals and Complementary Projects parts of the readme is not fulfilling in my opinion.

I first thought its a boilerplate, but its not. Then I thought this is recommendation of how to use react with typescript, like sort of best practices.
But then it directly jumps into React.StatelessComponent<P> etc without letting me know what these are for. I was getting lost as I was reading through because I simply have no idea what purpose these things serve. It took a while for me to realize React.StatelessComponent<P> is actually comes with @types react. I thought it was something this project introduced. (I am really new in react by the way).

I guess , just a suggestion though, readme can be improved to provide a smoother and faster onboarding experience to this repo, especially for beginners of React (and frontend programming)

Edit:
react-styleguidist was also hard to understand since I run the playground immediately and I was checking components folder and wondering 'how does this renders this???, there is only home component at the main and what I see on browser is really different'

[piotrwitek]

@Can-Sahin Thanks for feedback!

Note to self:
The action here is to add some motivational section, improve goals and complementary projects section and also provide better explanation of playground.

Related #79

[IssueHuntBot]

@BoostIO funded this issue with $20. Visit this issue on Issuehunt

[IssueHuntBot]

@BoostIO funded this issue with $10. Visit this issue on Issuehunt

[IssueHuntBot]

@IssueHunt has funded $20.00 to this issue.

---

• Submit pull request via IssueHunt to receive this reward.
• Want to contribute? Chip in to this issue via IssueHunt.
• Checkout the IssueHunt Issue Explorer to see more funded issues.
• Need help from developers? Add your repository on IssueHunt to raise funds.