News for hackers. Stuff that matters.
Re:Solid – A declarative JavaScript library for building use... by pax on Monday June 01, 2020 @12:45PM (#23380530)
My 2c of insight: I found Svelte's docs & examples greatly sweetened the on-boarding.

While I presume writing specs is a boring collateral, a friendly / bitesized / WISYWYG documentation would make a world of difference for the enthusiastic but less-than-ninjas of us.

The smarter kids can catch up faster, and some might not bother, already do react/vue. I personally found with Svelte a way tamer learning curve.

Re:Solid – A declarative JavaScript library for building use... by ryansolid on Monday June 01, 2020 @01:26PM (#23381116)
I agree. I would love to do more. The truth is there is just so much to do. It's hard to find a balance between writing cleaner docs and say solving Async Hydration with Suspended Components. I had the luxury early on to prioritize the latter which is why Solid is so feature rich given how much of it needed to be researched and built from scratch. I always knew it would catch up with me. But that's a good problem to have.
Re:Solid – A declarative JavaScript library for building use... by g8tor on Tuesday June 02, 2020 @03:12AM (#23388484)
Clear Docs is important because they say we spend 1x developing a product and 10x marketing it. In the developer experience world, docs are marketing.

Also, polished product and polished code deserve a polished set of docs. Just sayin'!

Re:Solid – A declarative JavaScript library for building use... by ryansolid on Tuesday June 02, 2020 @04:39AM (#23388989)
Volunteering?
Re:Solid – A declarative JavaScript library for building use... by g8tor on Tuesday June 02, 2020 @07:25AM (#23389871)
Ahahaha I know it sounds like that. But I realize what a massive task that would be. Am I volunteering? No. I appreciate your invite.. I'll email you if I change my mind.

I think a cool thing would be if the docs site was made in it. Self documenting.