How good are our docs, and how would you improve them?

@martriay, I’m still reading through the documentation. A little slower than I had hoped. Still have to run the business while continuing to learn. I plan to offer feedback to the group as it’s the least I could do to help others.

I will say, as a newbie, that one of the most difficult concepts to grasp is the overall structure of what constitutes a dApp. From a 10,000 foot perspective, it looks like you mint a token and you’re in business but when you delve into the process you find out that there are many nuances in the development of the dApp. The minting of the token is just a small piece of the puzzle.

I think a good place to add value would be a step-by-step guide to smart contract development or maybe some links to recommended reading for newcomers. I first read The Hitchhiker’s Guide to Smart Contracts in Ethereum by @maraoz. It contained good information but the contracts need to be updated again for Solidity 0.5.0+ as I had trouble with execution of some of them. Ib particular, with the ‘constant’ word as it has been deprecated and replaced by the ‘view’ word.

Finally, I think a point of confusion for me in the beginning but one that I now understand better is that the complete dApp doesn’t have to run completely on the blockchain. There is a local component of say, web apps in JS or PHP with some DB storage and only the open chain transactions need to be stored on the blockchain. It took some reading to figure this out. This could be more clear in a tutorial.

More to come as I read through more guides.

2 Likes