News for hackers. Stuff that matters.
Re:Write about what you learn. It pushes you to understand t... by simonw on Monday August 14, 2023 @09:58AM (#37121097)
I started publishing "TIL" posts a few years ago and everything in this post here resonated 100% with my experience of writing those.

The great thing about TILs is that once you form a solid set of habits around them they can be extremely quick to put together: the majority of my TIL posts take between 15 minutes and half an hour to write.

I make extensive personal notes on everything I'm doing (in GitHub issues threads or VS Code scratch documents) - turning those into a TIL is mainly about pasting those notes into a Markdown file and tidying them up a bit.

https://til.simonwillison.net/ is my collection so far.

I get a huge amount of value out of these. I don't particularly care if other people read them, the value is in helping me better understand the material and enabling me to refer back to them in the future.

I refer to some of them multiple times every week! This one for example, about Python packaging with pyproject.toml: https://til.simonwillison.net/python/pyproject

Re:Write about what you learn. It pushes you to understand t... by hosh on Monday August 14, 2023 @11:46AM (#37122410)
I think it’s a great habit and an effective method for consolidating what one learns … at least until someone cheats themselves using GPT to write up a TIL essay.
Re:Write about what you learn. It pushes you to understand t... by lfx on Monday August 14, 2023 @11:50AM (#37122466)
You mister Simon, you are the inspiration! For TILs and Py modules.

I wonder what's drives you to make so many Py modules? Do you see reusing modules for your own projects or do you have some other grand plan?

Re:Write about what you learn. It pushes you to understand t... by simonw on Monday August 14, 2023 @01:37PM (#37123972)
For me, the single most important thing about Open Source is that it means I can solve a problem once and then /never have to solve that problem ever again/ in the future.

So any code I write I like to open source, because that's the best possible way I know of ensuring I won't have to waste time solving that same problem again.

The other thing that helps is that I think I've found a cure for project guilt.

I used to feel guilty about my projects - each one was Yet Another Thing that I should be spending more time on.

The fix I discovered was to make sure every single one of them has good test coverage and comprehensive documentation.

Effectively I treat each one as something which can stand on its own if I effectively abandon it - the thing works, and is documented, and other people can use it as-is without me feeling guilty that I'm not constantly actively working on improving it.

I wrote more about that here: https://simonwillison.net/2022/Nov/26/productivity/

Re:Write about what you learn. It pushes you to understand t... by codeTired on Monday August 14, 2023 @02:12PM (#37124452)
I have this odd fear that sharing what I learned today will make me look stupid.

“Look it’s 2023 this dude just learned about http error codes”. Silly example but you get the idea.

Re:Write about what you learn. It pushes you to understand t... by p4bl0 on Monday August 14, 2023 @02:19PM (#37124555)
Obligatory XKCD : https://xkcd.com/1053/
Re:Write about what you learn. It pushes you to understand t... by fasterik on Monday August 14, 2023 @02:24PM (#37124633)
Anyone who thinks they don't have gaping holes in their knowledge, and criticizes others for it, is probably suffering from a severe case of Dunning-Kruger.
Re:Write about what you learn. It pushes you to understand t... by simonw on Monday August 14, 2023 @05:23PM (#37126985)
Yeah, if I see someone criticizing others because "that's so obvious, everyone knows that" the person I lose respect for is that critic.
Re:Write about what you learn. It pushes you to understand t... by zaep on Monday August 14, 2023 @03:01PM (#37125275)
The TIL-framing is not integral to writing and publishing little snippets. You can always omit a framing and stick only to the information.
Re:Write about what you learn. It pushes you to understand t... by johnnyanmac on Monday August 14, 2023 @03:54PM (#37126000)
Don't be afraid to take advantage of Cunningham. if you try asking or looking something up and it's not accessible, you'd be surprised how many people would come swarming once you start writing about it, departed to correct you ad show you links to valuable tribal knowledge.
Re:Write about what you learn. It pushes you to understand t... by simonw on Monday August 14, 2023 @05:21PM (#37126965)
This is one of the reasons I'm so keen on publishing this kind of thing - I like to make the point that you can have 20+ years of experience and still celebrate learning something basic like how to write a for loop in Bash.

No-one knows everything. I respect anyone who is constantly learning new things, no matter how basic those things might be.

Here's the most basic one I published recently: https://til.simonwillison.net/html/scroll-to-text

Re:Write about what you learn. It pushes you to understand t... by enjeyw on Monday August 14, 2023 @06:33PM (#37127610)
I love this post for this exact reason:

https://overreacted.io/things-i-dont-know-as-of-2018/

It's written by Dan Abramov who has been instrumental in React's development

Re:Write about what you learn. It pushes you to understand t... by stevage on Monday August 14, 2023 @06:48PM (#37127751)
Such a great post.
Re:Write about what you learn. It pushes you to understand t... by codeTired on Monday August 14, 2023 @06:57PM (#37127847)
That is such a good read.
Re:Write about what you learn. It pushes you to understand t... by gloryjulio on Monday August 14, 2023 @07:01PM (#37127895)
If you always take yourself as being stupid, you will never have this fear in the first place ;)
Re:Write about what you learn. It pushes you to understand t... by worthless-trash on Monday August 14, 2023 @08:04PM (#37128440)
You don't need to fear looking stupid. You gotta learn about it sometime ;)
Re:Write about what you learn. It pushes you to understand t... by flir on Tuesday August 15, 2023 @08:21PM (#37141142)
Turn off the comments ;) Or just publish anonymously.

I was actually considering doing this on gemini, because I've got that fear too. An append-only log habit is definitely helping me lately, why not make it (semi-)public?

I think there's a single meachanism underneath both this and rubber ducking. There's something about getting your thoughts in order at a verbal (or textual) level that aids understanding.

Re:Write about what you learn. It pushes you to understand t... by belic on Monday August 14, 2023 @03:50PM (#37125942)
How often do you go over these notes and review or study them? I don't mean ones you need and hence use, but all of them? I have an issue where I feel I have so many notes that I forgot what's in there, and sometimes I remember or find out when I don't need it, and I seem to lack a habit of reviewing my notes.
Re:Write about what you learn. It pushes you to understand t... by simonw on Monday August 14, 2023 @05:24PM (#37127010)
Some of them I remember and refer back to often. Others I completely forget even exist.

I added "related TILs" to my site a while ago - here's a TIL about how I built that: https://til.simonwillison.net/sqlite/related-content - and as a result occasionally I'll post a new TIL and the related ones will remind me of an older one.

Occasionally I'll completely forget the subject of the TIL itself! I was delighted to randomly stumble on this one here https://til.simonwillison.net/html/datalist the other day (after clicking my "html" tag from another TIL) which reminded me of the HTML datalist element, which I had forgotten existed.