2 ms·
Money take: > If the user can’t get a functional project by the end of a tutorial, the tutorial failed. So that should be priority number one. I did an entire
by mschuster91 10mo ago
Money take:
> If the user can’t get a functional project by the end of a tutorial, the tutorial failed. So that should be priority number one. I did an entire Akademy talk talking about how docs is part of the product, and broken docs effectively means a broken product.
So, SO many projects fail at this!
The NodeJS scene is particularly bad (made worse by the constant churn), but I was playing around with OpenStack right during their Python 2=>3 migration, or many moons ago I was involved in running a DC/OS cluster, and ffs many Docker images and helm charts suffer from the same issue. There's a reason many people went for Bitnami images and charts over the "official" images/charts... at least the Bitnami documentation actually made sense and worked.