In my experience the best docs for the average codebase I encounter are their unit tests. At least there you can see how the devs expect their library to be used even if they don't provide actual examples or actual docs for how to use it.
My hot take is that auto-generated docs from static types usually suck. Getting a randomly sorted list of function signatures is about as useful as just reading the source code.
Docs should get to the point and show people how to use the thing and fall back to type signatures for the nitty gritty bits when the examples don't suffice.
Golang/Java/Etc projects often just dump their types into an HTML page and call it a day without any context given to how to use it.
No confirmation yet, but the head librarian or whatever seemed interested in talking more about the workshops I wanna run to teach folks some skills to have more control over their computers.
I think devtools and bookmarklets might actually be more useful in the near term than full blown apps or whatever since it can give people the most broad range.
Beep boop time to wire up some codes.
Today in "Mauve Remembers How To Golang":
- Set up an IPLD blockstore (or whatever they call it)
- Wire up an ndjson parser which parses dag-json
- Wire up the IPLD Blockstore to a ProllyTree blockstore
- Sketch up indexing data into the tree
https://github.com/RangerMauve/ipld-prolly-indexer/tree/initial
i made a MASTODON AWESOME MODE userstyle!!!
it makes the background and text cycle the colors of the rainbow slowly, as well as turning everything into comic sans!!!
userstyles are custom CSS thingies you can use with a browser extension like stylus to override the default appearance of a webpage with something prettier
be sure to point it at the URL of your instance in the settings after installing it!!!
Luckily I can bend computers to my will by sticking my hand into their brain and rummaging around to route around problems.
Tomorrow me can figure out a more permanent solution.
Snake feeding
Lol! Just got my corn #snake out for feeding and it decided it didn't want to wait for its rat and chomped onto my gloved finger 🤣
She tried wrapping around my whole forearm whuch is pretty ambitious for her size. Had to do some gentle wrastling to untangle myself.
Hello #CoSocialCa!
A June 2023 update on the blog https://cosocial.info/cosocial-ca-update-june-2023/
* We’re currently at 62 paid co-op members
* We've got a great group of volunteers, could use some more across trust & safety, comms, & membership
* Follow #CoSocialHour
* Co-op Annual General Meeting (AGM) will be this fall; members will vote for a board and discuss major issues
Yikes, seems like #WebTorrent is having trouble reaching the Mainline #DHT today or something. :/
Not ideal when trying to run tests! Might be a good reason to set up some more bootstrap nodes.
Having a rough one focus-wise today.
Listening to #DeathGrips and fixing up #BitTorrent integration with #DistributedPress
Occult Enby that's making local-first software with peer to peer protocols, mesh networks, and the web.
Exploring what a local-first cyberspace might look like in my spare time.