HN user
pomber
https://pomb.us
Author here.
It's a shame commercial vendors don't do this sort of thing for their product docs more regularly.
I've been trying. I'm even building something to make adoption easier, not launched yet but it's here https://docskit.codehike.org
Nice! Do you think it could be adapted to other docs sites?
I made a small clone of the tutorials section (https://clone-swiftui-tutorial.vercel.app/) where the content is already Markdown (and use codehike to turn the markdown into a rich UI). This made me realize that codehike is AI-friendly, in the sense that even for non-linear UIs the original content is still AI-readable Markdown.
yes, try to find them on medium.com directly. I'm afk travelling right now, I'll update the links next week
Author here. I'm working on a new version of Code Hike, more flexible. Docs: https://v1.codehike.org/docs
If anyone wants to try the API for the first time, I've made this guide recently: https://gpt.pomb.us/
Most popular post https://pomb.us/build-your-own-react/
Posted something new today: https://pomb.us/
To be fair, it may be the "biggest change ever", but it doesn't change too much. It buff some units that were bad, nerf some units and techs that were too good. But the general meta remains the same. The devs are really good at introducing changes.
By the way, https://github.com/sponsors/code-hike/
I maintain one of the selected projects. $20k means that I can focus on the project without taking any freelance work on the side for a while. Hopefully making the project more attractive to sponsors, hopefully snowballing into more OSS and less freelance.
Thank you!
As the maintainer of one of the selected projects (https://codehike.org/), I really appreciate what GitHub is doing, putting the money and trying different approaches (last year it was $450K across 900 projects).
Thanks. Meta made a generous one-time donation via Open Collective https://opencollective.com/codehike
that's right
My approach with Code Hike (https://codehike.org/) was to add a sponsor-wall to some parts of the docs, not sure if it falls under any of those categories. It's working decently well ($600 per month).
Not Markdoc, but there are several OSS examples of how you can do something similar with MDX + Code Hike. https://codehike.org/
I like that they write it as a trade of. I think I still prefer the maintainability complications of "docs as code" https://www.youtube.com/watch?v=xEu3t-KJVVg
that doesn't use your list of muted keywords
I would make more emphasis on the Muted Words list: https://twitter.com/settings/muted_keywords
That's what makes Twitter bearable for me.
Strange, I don't see the lock on the Annotations demo.
Yes, the stable API will be MDX-only at least for the first version
Thanks. I couldn't reproduce the "Hotel California" bug, also Chrome on Android. Let me know if you have an idea of what could be the issue.
Thanks for the feedback.
More confusing, a lot of the locked demos had been unlocked by sponsors, so clicking on them worked! So why was the lock still there?
I didn't understand this part. Are you seeing locks on the first three demos?
I use the GitHub API for getting the sponsors info.
Some of the sponsors are fixed one-time (or two-times) sponsorships. I add them manually if the contribution is considerable.
Here is an example:
This page: https://code-hike-sample.vercel.app/ is created entirely from this mdx file: https://raw.githubusercontent.com/pomber/code-hike-sample/ma...
Hi! I'm looking for feedback and ideas before making this production-ready.
You can see an early ancestor of this project on this post https://news.ycombinator.com/item?id=21536789 from two years ago (which had great feedback!).
If you want to try it, beware that current docs are minimal. If you have questions or feedback GitHub Discussions is the best place to post them. Thanks!
I'm releasing it here soon: https://github.com/code-hike/codehike
This one was updated after fiber and hooks: https://pomb.us/build-your-own-react/
Link to the repo: https://github.com/code-hike/video-tutorial-maker