Hacker News new | past | comments | ask | show | jobs | submit login

Sometimes the most valuable guide is a working example. Lord knows, there are so many docs out there that keep prattling on and on instead of showing me the code.



99% of the working examples I encounter in JS config don't work by the time I get to them.


a working example that you don't understand and just copy over and over again into new projects.

This eventually turns into an incantation and magic. It's how crap gets built up and poor decisions get propagated.


> a working example that you don't understand and just copy over and over again into new projects.

Once you have a working example, you can go through it line by line and figure out what it is doing.


Honestly, I've always preferred to have somebody's example plus the reference documentation.

Learning not only what it does but where it's documented - and having to go look for myself to do so - fixes it in my memory a lot better.

I have a years old set of npm/etc. configs in a project I noodle on occasionally, and when I re-open them to look I remember exactly what they do -because- I started from a boilerplate and then went and learned how all of it works.

That doesn't mean an explanation wouldn't still be helpful for a bunch of people who aren't me, but honestly having the tsconfig commented like that is more than sufficient for -me- to be happy.


Which the author would be kind to do and post with the example.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: