Open Keyrxng opened 4 weeks ago
I don't like this media forward approach because this will quickly get out of date. Similar to readmes.
It's an easy and nice to have asset but I would not like to invest much in this direction.
We should have a solution that self improves.
We should have a solution that self improves.
Should we go hard on creating automated docs via a workflow then and annotate everything in sight and host it on gitpages or gitbooks or something?
That's the only thing I can think of that can stay up to date in real-time with our codebases
Chat bot and it updating readme.md on every merged pull is enough I think.
Oh right I thought when you said docs you meant real docs with their own page a contributor can visit like https://supabase.com/docs but for UbiquityOS, why aren't we doing that out of curiosity, the sync issue?
updating readme.md on every merged pull is enough I think
Is this an AI task or are we enforcing this as a rule for PRs?
Docs page might be appropriate only on finalized products. Lots of unnecessary busywork otherwise.
AI task
With the SDK it takes 5 minutes to set up + you can run locally without needed the Kernel, at least that's what I do to dev right now. Problem is that very few plugins use the SDK at the moment.
Ideally one day running the kernel will be as easy as yarn start.
! Error: HttpError: Resource not accessible by integration - https://docs.github.com/rest/issues/comments#create-an-issue-comment
test comment
! Error: HttpError: Resource not accessible by integration - https://docs.github.com/rest/issues/comments#create-an-issue-comment
interesting...
Should be fixed by https://github.com/ubiquity-os-marketplace/daemon-disqualifier/pull/42
! Error: HttpError: Resource not accessible by integration - https://docs.github.com/rest/issues/comments#create-an-issue-comment
Recently it's came to light that setting up the kernel and running plugins is not straightforward and new contributors even core team are having issues with it so I'm suggesting we do more than just improve docs or #171. Both will help but not as much as my suggestions below in my opinion and I'll explain why.
Building a UbiquityOS plugin in 60 mins or less
Someone records themselves speedrunning the creation of a very simple plugin, maybe even just the current
hello-world
that exists inplugin-template
that I wrote before.Bonus:
"SpeedRun UbiquityOS"
https://speedrunethereum.com/
We make a set of "challenges" that ease a contributor into the eco-system piece-by-piece.
Why?
I never spent a huge amount of time in "tutorial-hell" but I've watched a few things like this and it works wonders to be able to see it live as it happens. It's even better to understand the developer' intentions so if we can hear them tell us why they are doing x, y and z as they do it the viewer gets a much better idea of when/why/where they'd also need to do the same thing.
Maybe creating two of these videos (if chosen), one for the simple single plugin and the second with multiple plugins running in parallel locally or something? Something a little more advanced anyway so that we can get further into the quirks