Tbh, this sort of auto-generated docs from source code is not all that useful, since you get that same information right in the IDE via the language server.
The important documentation part that's currently missing is how everything is supposed to work together in the stdlib, not the 'micro-documentation' of what a single type or function does. And for this sort of information it's currently indeed better to look at example code (e.g. the stdlib's testing code).
IMHO it's way too early for this type of high-level documentation, since things change all the time in the stdlib. Putting much work into documenting concepts that are discarded again anyway doesn't make much sense.
So, it feels to me ideally within the same classroom there should be a natural way to work on your own pace at your own level. Is it possible? Have no idea - seems not, again primarily because it requires a completely different skillset and attention from teachers.
Then came senior year. AP Calculus was a sh/*tshow, because of a confluence of factors: dealing with parents divorcing, social isolation, dysphoria. I hit a wall, and got my only quarterly D, ever.
The, "if you get left behind, that's on you, because we're not holding up the bright kids," mentality was catastrophic for me - and also completely inapplicable, because I WAS one of the bright kids! I needed help, and focus. I retook the course in college and got the highest grade in the class, so I confirmed that I was not the problem; unfortunately, though, the damage had been done. I'd chosen a major in the humnities, and had only taken that course as an elective, to prove to myself that I could manage the subject. You would never know that I'd been on-track for a technical career.
So, I don't buy that America/Sweden/et al. are full of hopeless demi-students. I was deemed one, and it wasn't true, but the simple perception was devastating. I think there is a larger, overarching deficit of support for students, probably some combination of home life, class structure, and pedagogical incentives. If "no child left behind" is anathema in these circles, the "full speed ahead" approach is not much better.
Your one bad year doesn't invalidate the fact that it was good to allow you to run ahead of slower students the other 9 years. It wasn't catastrophic for you, as you say yourself you just retook the class in college and got a high grade. I honestly don't see how "I had a bad time at home for a year and did bad in school" could have worked out any better for you.
> So, I don't buy that America/Sweden/et al. are full of hopeless demi-students. I was deemed one.
A bad grade one year deemed you a hopeless demi student? By what metric? I had a similar school career (AP/IB with As and Bs) and got a D that should have been an F my senior year and it was fine.
Not every software project needs to attempt to maximize productivity. Not every software project is a business. Some are just created by people who enjoy programming. By hand. It's OK to set that as a culture. I guess I get it.
I don't mind AI tools, I use them judiciously, but sometimes I just want to do some coding - for me it's a genuinely relaxing and mentally satisfying activity to write some good code -, and I'm happy there's still others around me who do as well. Gardening context prompts and what not just isn't nearly as fun as just doing it, and not every project has to be economical. This one is yet another terminal emulator; it's not going to be the next unicorn. But I bet it's fun to hack on.
This project was literally born from a place of "because I want to".
First, porn.
Second, artificial botting to make your game look active.
Third, hire a art developer in india, VPN them to your AI tool, fire them when the game is done.
You really should check your prescription rose colored glasses.
I thought current gen robots would be an order of magnitude less efficient. Maybe I'm misunderstanding something.
Where we excel is energy storage. Far less weight, far higher density.