Samuel ツ
@samuellhuber.eth
Since I always talk about stability and naming here's why it matters! I had ~ 70 doc pages covering Farcaster built on the dTech blog. Yes that's in my free time. Work is developing and going viral for our clients. Now rewriting the whole Astro blog from Frames V1 to a Mini App took ~2 hours including setup for the mini app itself and making sure it's handled properly in Astro. Then going through the Frames V2 docs and JUST changing names and making sure context is correct > 1 more hour. So now I am ready to deploy and test without notifications, without adding the mini app, without sharing and ~3-4 hours down. I knew what I got myself into and minimised the docs I wrote to not have to do as much, but just imagine I had more content?! lol That's why am so vocal about naming, stable APIs and focusing on that. In our ecosystem if we can minimise that time spent on reworks vs new content + apps then we all get better. Though I know we are on the frontier and changes like that will happen again.
4 replies
1 recast
30 reactions
limone.eth 🍋
@limone.eth
the question is: arr you sure you need to do all that work? are you sure all that written docs on top of the official ones really matter?
1 reply
0 recast
0 reaction
Samuel ツ
@samuellhuber.eth
People tell me they appreciate it and use them. I get DMs about them weekly and people at conferences tell me they prefer them. So idk if it’s worth it, but seems like it from feedback I get
1 reply
0 recast
2 reactions
Samuel ツ
@samuellhuber.eth
You do realize until ~1 week ago there basically was no good docs ?
1 reply
0 recast
1 reaction
limone.eth 🍋
@limone.eth
i realize it ofc, but it’s all so experimental i don’t expect uni to teach me React cause it evolves so much faster then the pace they can keep for the same reasons with such experimental sdks it doesn’t make sense to me to spend too much time on docs or at least i accept that it’s not stable naming and structure
2 replies
0 recast
1 reaction
limone.eth 🍋
@limone.eth
that said ofc i’m grateful for your work, i share some of your links frequently
0 reply
0 recast
0 reaction
