Show newer

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.

Show thread

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.

Honestly, following some Ottawa folks is already paying off. Now I can learn stuff without having to search for it. (an impossible task for me)

reddit api #gdpr 

function delete(comment) {
database.get(comment.id).put({
deleted: true
})
}

function render(comments) {
return comments.filter(
comment => !comment.deleted
)
}

Low key thinking of running my own DNS server. I wonder how much it'd cost to give my home fiber connection a static IP. 🤔

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

github.com/RangerMauve/ipld-pr

Twitter is falling apart. Reddit is falling apart. Facebook fell apart ages ago. Meta is a trashfire. Instagram is baloney. Google can't even search for anything you want anymore.

You know what website still miraculously works?

Wikipedia.

You should donate to keep it that way.

The life of a technomancer can be stressful sometimes but I do so enjoy mancing that tech!

Like, dang. Being a domain expert and having my expertise prove to be useful is pretty satisfying.

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!!!

userstyles.world/style/10367/m

#mastodon #userstyle #userstyles #CSS #theme

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.

Show thread

Yay! Love it when data gets corrupted on prod just as I was about to go offline. :)

Shit, gotta start hoarding data in preparation of the web collapsing. Anyone got recommendations for a box I can just put in my home to reliably store a petabyte or two of data? 🤪

Snake feeding 

Lol! Just got my corn 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 cosocial.info/cosocial-ca-upda

* 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

Sometimes I forget I'm an open source weirdo, then I think about using a thing and am like "Hmmm, but it's not open source..." and then it clicks and I have a chuckle.

LOL! The only thing more jarring than forgetting how loud my volume is when I start listening to a track is accidentally quitting my browser in the middle of a loud track to be thrown into silence.

Yikes, seems like is having trouble reaching the Mainline today or something. :/

Not ideal when trying to run tests! Might be a good reason to set up some more bootstrap nodes.

Show thread
Show older
Mauvestodon

Escape ship from centralized social media run by Mauve.