Show newer

@f0x What is the intended audience ? I thought it was fairly well written and easy-enough to understand, but also I've done a lot with react -- I bet someone who has never used react before would be slightly lost if they read it.

Regarding the part where it shows the normal react useEffect component and then describes what that code is doing -- I think it might be easier for folks who are new to react if it mentioned that in order to understand the next section, you probably need to understand react function components. Then it can offer a link to a primer on React function components and another link to a primer on useEffect.

When you get into explaining what the code does line by line, I think it might help to show the whole code block first, then go through it again line by line or section by section alternating between sections of the code block and explanation text.

(right now its just code block, then one big block of explanation text. By breaking the code and explanation into smaller chunks it reduces the amount of working memory that the reader has to allocate in order to understand what you wrote)

When you mention stuff offhand like the normal useEffect function interface specifying that any return value should be a cleanup function, I think it might be good to hyperlink that part to the docs that describe the spec and/or to an example code block that shows what that looks like. I didn't even know that this cleanup function return value existed! So I would have been delighted to click "open in new tab" on it and read more.

This isn't based on any theory of technical writing or anything I guess its just my 2c.

I never studied technical writing formally, but in my opinion if you study any form of writing like written journalism or creative writing, it will help your technical writing a lot too! When I was in college I took a lot of creative writing classes and I think those helped me considerably.

Forest boosted

#GoToSocial 0.3.0 aka Stimky Sloth is out now

github.com/superseriousbusines

This release includes pubic profile pages at last! Migration to the new version is pretty easy, see the release for details.

Have fun with your new profile pages!

Current status: resisting the human instinct to write new database software from scratch

I started making these silly images for mainstream social media platforms when I announce my streams because my friend told me that text-only posts (especially containing links) will be buried automatically by them and its much better to post an image and then post the link as a comment. IDK if this is still true, I think its silly but whatever, when in rome....

@lawremipsum@mspsocial.net I was very lucky / privileged in that my parents pushed me to do this but also didn't force it against my will. and it helped that my dad worked at the college. I didn't really get any social connection out of school because of how my family treated it as a corrupted/evil institution to be avoided or exploited, not a legitimate place for young ppl to find community. I didn't get real community (besides online) until going to college and becoming an alcoholic

@lawremipsum@mspsocial.net I was home schooled, when I did go to school for a short time I took the "AP" classes in highschool, my experience in class was being told by my classmates that everyone thought i was most likely to be a school shooter. They were v. wrong, I just didn't really want to be there, i was putting up with it because i wanted to make sure I could get into college. The second semester of "highschool" I went to, what would have been my senior year, I took all college classes.

@lawremipsum@mspsocial.net ohhhhh y'all are talking about something specific in public school, I thought this was just about how adults treat kids in general

@lawremipsum@mspsocial.net where's "it fucked me up but I came out OK" ?

stream.sequentialread.com/

Implementing support for serial console access to vms in capsul-flask

🙎🏼‍♂️👨🏿‍🦲 Fracus and Darwin 💿🎚️🎛️💿

@f0x maybe you are just a fan of Andromeda Software Development ???

@f0x @starless @j3s thanks for the update I was out buying groceries 🍅 🧀 🍞 🥬

There's nothing I can do right now, cyberwurx.com and customer.cyberwurx.com are all down right now. I can't ping baikal. it sounds like they are trying to get everything up and running again after a power failure. I've sent a message to cyberwurx on facebook 🙃

@f0x Yeah, what happened to me today was an example of link rot -- in theory the go module proxy would have solved this problem, but this time it caused it.

Go has always been driven by google and decisions they have made about its architecture have always been primarily about what's good for them -- For example the way modules used to work, where they weren't versioned, (different version is a different repo), seems crazy everywhere except at google.

Honestly this is just an example of "man yells at cloud" but I think its important to be aware of how the module system works; I'm kinda 😳 that I didn't even really know about this until it broke my workflow.

I liked the idea of golang's module system (every module is just a url) because it seemed to invite more decentralization in packaging, welp, today I discovered firsthand just how wrong I was: github.com/golang/go/issues/51

Show older
Pixietown

Small server part of the pixie.town infrastructure. Registration is closed.