MurphyA/hacker-news huggingface dataset:
Show HN: Docucod – Automatic documentation for any codebase
by clidey | 2025-07-30 19:42:09+00:00
Hi HN, I'm Hemang from Clidey, and we are working on Docucod. Docucod is a tool that automatically generates and maintains documentation from any repository.

* What is the problem? * My co-founder and I have both worked in large corporates like J.P. Morgan, Morgan Stanley, smaller companies like Palantir, and continuously see the issues that stem from unmaintained documentation.

Most codebases are under-documented, comments are sparsed, types aren't always obvious, and there's often a lot of knowledge that is forgotten as time goes on.

The deeper you go, the harder it gets to understand how things work. This slows down onboarding, wastes time during debugging, and increases the chance of things breaking.

Until today, we have been running pilots with small to medium sized companies and startups tweaking the product and gaining lots of feedback.

Today we want to open it up to the public with a release of the generation service!

* Try it out! * Go to https://docucod.com/oss and put your repository URL there. Once generated, the link will be visible.

You can also put the prefix url in front of the repo url: https://docucod.com/docs/<repo-url> (example: https://docucod.com/docs/https://github.com/clidey/whodb)

Please note this will work only for public repos up to 100MB.

How it works: Docucod analyzes the codebase, parses files, comments, types, examples, and the readme, then builds a static documentation site you can browse immediately — no config, no setup.

It tries to surface useful context automatically so you don’t have to read the code line by line to figure out what’s going on.

There is diagram generation with Mermaid, and we are working on generating images and later videos!

The publishing is done with our own static site builder called Dory ([https://github.com/clidey/dory](https://github.com/clidey/dory)).

It handles parsing, structure extraction, and HTML generation. Dory has been built with handling AI-generated MDX in mind, which is an interesting hurdle to overcome.

We're still fleshing it out, so PRs and feedback are very welcome.

What’s next: Right now we support public GitHub repos (private support coming). We’re also working on features like code search across the docs, customized responses based on the user's query, better navigation, theme customization, and integration with CI pipelines.

If you check it out, I’d really appreciate your feedback — both the good and the bad. Does it solve a real problem for you? What’s confusing, missing, or just not helpful?

Thanks!
by kkylin | 2025-07-30 19:42:19+00:00
I recently noticed deleting a frame doesn't seem to free the associated memory; you can see this by running Activity Monitor and opening and deleting some frames. It's on the order of 10s of MB (exact amount depends on size of frame, whether it is fullscreen, etc). This is not much on a modern machine, but if you open and close lots of frames everyday (as I do) and keep Emacs running for weeks at a time (I do that too) then it starts to add up. My current kludge is to add a hook to resize a frame (which deallocate most of the frame memory) before deleting. This keeps the leaked memory to a level that is more tolerable.

(I've dug through the ObjC source, specifically "nsterm.m", but haven't quite figured out the core problem.)

[edited slightly for clarity]
by tangled | 2025-07-30 19:42:39+00:00
To quote the NYTimes:

“Despite the desperate humanitarian crisis, a survey conducted in May by the Institute for National Security Studies at Tel Aviv University found that 64.5 percent of the Israeli public was not at all, or not very, concerned about the humanitarian situation in Gaza.”

“About three-quarters of Israeli Jews thought that Israel's military planning should not take into account the suffering of the Palestinian civilian population in Gaza, or should do so only minimally, according to another recent survey by the Israel Democracy Institute, a nonpartisan research group in Jerusalem.”

https://www.nytimes.com/2025/07/28/world/middleeast/israel-d...
by bawolff | 2025-07-30 19:42:40+00:00
> a ceasefire provides room for diplomacy that might lead to concessions from both sides for their atrocities, and thus might lead to peace and equality

We've had something like 100 years of failed diplomacy at this point. I don't know the solution to this conflict, but i can understand why both sides suspect further diplomacy won't lead anywhere unless something fundamental changes.
by macgillicu | 2025-07-30 19:42:44+00:00
The guy behind the language - Sylvan Clebsch - seems to have a very solid background, and current professional situation. He works at "Microsoft Research Cambridge" in the Programming Language Principles group.

Read the "Early History of Pony":

https://www.ponylang.io/blog/2017/05/an-early-history-of-pon...

My point is - sure, it doesn't have a handful of massive companies stewarding it like Rust. But, on the other hand, it's made by a guy with really serious chops, who has a solid programming language related job. So while not being as industry-sanctified as Rust, or Java, it seems nonetheless like a language that could go places!
by schmidtleonard | 2025-07-30 19:43:12+00:00
Nope. Private capital allocation decisions are the foundation. It is a mistake to mix this with wishful thinking, the same flavor of mistake as claiming "socialism is about making economic decisions that reflect the will of the people rather than the will of the rich," it assumes success at the aspirational principle when that assumption is something you must avoid at all costs if you want to understand success/failure at achieving the aspirational principle. Instead, a discussion about the foundation of a system should be very carefully confined to what the system actually does: capitalism is about private capital allocation decisions, socialism is about public capital allocation decisions, and in practice everything is mixed.

Anticompetitive incentives and behavior are a natural emergent property on top of the private ownership foundation: network effects, platform effects, last mile dynamics, dumping, hell even economies of scale are intrinsically anticompetitive at the same time as they are intrinsically beneficial. Regulation to restore competition amid these natural anticompetitive tendencies can keep them in check and most people would agree this is generally a good idea -- but most people don't make the capital allocation decisions and most people don't learn about the world except through media controlled by people who do, so not only are the regulations 3 stories above the foundational principle, they are doubly insulated from effectively checking the dark forest on the second story by the very nature of the foundation itself.

You have probably heard about how misalignment emerges in socialism, because that is a story the jedi would tell you: capital allocation decisions made without skin-in-the-game accountability tend to cause malinvestment because as far as elected representatives are concerned the job is the product. Of course, a socialist government is aware of this tendency and tries to control it, just like a capitalist government is aware of anticompetitive tendencies in its own economy and tries to control them. The degree of success varies.

When there is nothing to compare against, propaganda can hide almost any mismanagement, so I am glad that we seem to be entering a second period of genuine competition. I'm less glad that this brings with it a second period of genuine "hopefully we don't kill each other / ourselves," but so it goes.
by dylan604 | 2025-07-30 19:43:36+00:00
I did one of these balloon launches myself several years ago, and attempted to build a flight computer myself with Arduino and multiple sensors. I could not find an efficient way to read all of the data from the selection of sensors in the limited memory, so I wound up using a Mega. Nobody involved was a licensed radio operator, so our live tracking was very primitive. It wasn't until after 45k' that we realized our GPS tracking stopped tracking at that altitude because why would a civilian be at that altitude. Of course we didn't know that until researching it after recovery, but we were very relieved when it started to updating once it came back under 45k'. Unfortunately, something happened (my coding to be sure) that caused the log to not be written as expected. Was hoping to be able to compare the GPS of the actual flight against the forecast model we used. This is the very thing I would have loved to have for future launches. I even made friends with a licensed operator to make it legit. (couldn't be bothered to take the test myself)

One thing to keep in mind for anyone wanting to do their first one. If you go to the trouble of printing up contact info for an "If Found", don't forget to attach it before lift off like I did.
by liquid99 | 2025-07-30 19:43:38+00:00
U+3164 (Hangul Filler) is a Unicode character that looks empty but isn’t. It was meant for Korean syllables, but now shows up in things like odd text tricks. People use it for blank WhatsApp messages, invisible replies, and as a spacer where normal spaces don’t work. It renders blank in most places, which makes it confusing and interesting.
by adkaplan | 2025-07-30 19:43:47+00:00
I've struggled with this too. I want to only use my phone but the quiet focus that a view finder gives me allows better attention to detail, the edges of the photo, and subtle alignments of parallax objects. I find it much harder on a phone or with live view on a proper camera. It's like -- for a moment, I am the camera and I'm about to make a record of a moment. I don't get nearly that feeling with a phone despite years of trying to convince myself its the same
by ineedasername | 2025-07-30 19:44:09+00:00
I guess I was thinking more the larger DOGE project, because this isn't just NASA as such, this is the model it followed across the board-- State department, Nuclear safety, lots more, and someone else in these threads pointed out that tons of the people whose programs were cut were working on programs no private sector player will care about-- too niche, too pure research.
by aprilthird2021 | 2025-07-30 19:44:25+00:00
I feel like this should have some kind of "promotional" or "ad" label. I agree wholeheartedly with the words here, but I also note that the author is selling the fast developer tools she laments the dearth of: https://www.catherinejue.com/kernel

Again, no ill will intended at all, but I think it straddles the promotional angle here a bit and maybe people weren't aware
by 9rx | 2025-07-30 19:44:28+00:00
> You need ~$1M worth of equipment to farm 80 acres

All new? That seems way too low. You'd struggle to get into a combine alone.

Used? That seems way too high. I doubt I'd get any more than $300k for my equipment (and that's more than I paid) if I were to sell it today, and it's pretty nice equipment compared to what I see a lot of farmers using.

> 80 acres (~$1M worth of land)

We always wonder why so cheap? The 18 acres for sale down the road from me wants just about $1M (I expect that will be a hard sell, to be fair). The 130 acres further down the road wants nearly $4M (quite realistic; comparable parcels have sold for more). If you could pick up 80 acres in these parts for $1M, you just won the lottery. And, to be clear, it's not like on the edge of a city or something where other interests are driving up the price. It's just farmland. The yields are respectable, but not quite like Illinois will produce.
by mlsu | 2025-07-30 19:44:42+00:00
I have noticed this as well, and yes it hasn't always been this way.

My theory is that we are simply too wealthy. For the average rich person (the top 20-30%), the first $70,000 goes to real companies who sell real things for money. Past that and it all is just kinda funny money. In our society there are actually a ton of people making this kind of money, so there's just this huge chunk of money that isn't really tied to anything real. If you lose $100k on cryptocurrency, or you spend $800 on some metaverse thing, it's fine, you can still buy food.

Of course this is also why people who don't make this kind of money are so baffled (and angry). Hearing that some no product company [1] was sold for billions of dollars feels insane when you're seriously considering the difference between a $5000 and a $6000 car.

[1] (https://openai.com/sam-and-jony/)
by timerol | 2025-07-30 19:45:07+00:00
> Does everyone at Oxide have the same equity grant?

> equity compensates for risk – and in a startup, risk reduces over time: the first employee takes much more risk than the hundredth.

I think that paragraph answers the question pretty clearly. As an Oxide employee you will get equity. It will generally be less than the people that came before you, but more than people that come after you. So it's obviously not the same as everyone else
by alkyon | 2025-07-30 19:45:24+00:00
Thank you, this is what I wanted to know:

"‘If you feed Gazans, they eventually eat you,’ the Israeli stand-up comedian Gil Kopatz posted. ‘It’s not genocide, it’s pesticide.’ According to a survey commissioned by Penn State, more than 80 per cent of Israeli Jews now support the expulsion of Gazans. Compassion for Palestinians is taboo except among a fringe of radical activists. When Ayman Odeh, a Palestinian member of the Knesset, posted a tweet celebrating a recent prisoner exchange, he was denounced for seeming to equate the predicament of jailed Palestinians and Jewish hostages: ‘Your presence pollutes the Knesset,’ a colleague told him."
by bregma | 2025-07-30 19:45:48+00:00
Satiety is mediated by cholecystokinin released in reaction to the presence of fatty acids and certain amino acids (partially digested fats and proteins) in the duodenum, or first part of the small intestines. That hormone stimulates the release of bile and pancreatic enzymes (necessary for the further digestion of fats and proteins) and also parts of your limbic system, which is the part of your brain that regulates satiety. In particular, it affects the ventromedial hypothalamus.

In other words, fats and proteins satisfy your hunger. You can eat really dense carbohydrates until your stomach bursts (it won't but it might feel like it's going to -- it's the stretch receptors signalling your limbic system to stop or it's going to tell you to vomit) and you still won't feel satisfied. Slather a bit of (protein-rich high-fat) peanut butter on your celery sticks and you'll be fine.

The best advice is balance.
by quickthrowman | 2025-07-30 19:46:03+00:00
How is that relevant?

Yes, the name Palestine is derived from the Philistines who used to inhabit the area 3500 years ago. The region has been urbanized for 7-9k years and inhabited by many different groups. Jews, Greeks, Romans, Muslims, and I’m sure there’s more. It has an exceedingly complex history.
by dkarl | 2025-07-30 19:46:16+00:00
> - Some people just don’t like to eat that much. They don’t actually have a faster metabolism. Eating is just a chore to them so they rarely do it.

I had two friends exactly like this. One of them was 6' and 135lbs when he started college. Another was 5'5" and under 120lbs. They both said that growing up they thought food was gross and only ate because it was the only way not to be hungry all the time. They both started enjoying food in college and gained a bunch of weight. The one who is 5'5" topped out over 200lbs and now weighs around 180. The other I lost track of, but he was on the same trajectory, gaining 30lbs during our undergrad years.

Your first thought might be that they grew up poor, or that their parents didn't have tasty food around the house, but they were both middle-class, and there were lots of regular foods like pizza and burgers that they disliked as kids and ended up enjoying to excess as adults.
by theoriginaldave | 2025-07-30 19:46:16+00:00
Back to the OP, the hunger and satiety signals are very complicated and only partially driven by the digestive track.

I'm a fatty. I've lost a lot of weight but my body knows I used to be fat and it wants to be fat again.

A very potent signal for hunger or fatigue is when your fat cells get small i.e. you've burnt a lot of fat, and your little fuel cells are feeling empty. Each shrunken fat cell sends out a chemical "feed me" signal. And they are very very persuasive.

And the kicker is that when you fill them up, they want to be maintained at full. But if they're full too long, or get too full (persistently increase body fat by a few percent(, it triggers mitosis and you now have two half full fat cells who are both shouting "Feed me"

To add insult to injury when you lose weight, you don't kill off fat cells, you just have a bunch of really hungry fat cells shouting for a cheeseburger.

The nice thing about the GLP1 drugs is that they quiet the shouting. So you just don't get the demonic urge to feet all your wilting fat cells.

The bad thing about it is that the shouting is still there, and as soon as you quit the drug, you can get overwhelmed and go back to overeating and your weight and percent body fat go right back up
by shkkmo | 2025-07-30 19:47:04+00:00
> It's quite another to claim "collective punishment", and that doesn't stand up to scrutiny.

17,000 kids killed directly by Isreal.

> the UN refuses to collect them and distribute them

A blatant lie.

Actual news coverage of that border crossing:

https://apnews.com/article/aid-gaza-hunger-united-nations-e7...
by TimorousBestie | 2025-07-30 19:47:05+00:00
There’s an exceedingly strong cultural drive to keep farmland “in the family” even if it impoverishes or otherwise inconveniences the descendants.

I had a coworker once who lives in this region and owns some amount of farmland in a similar situation. He could have sold it and moved his family to <insert modest paradise here, in his case Florida> at any point; even now I think it would be easily done, if not as easy as in the past. But of course he still lives there, immiserating himself to keep the farm barely viable and working a second job to provide a livable salary.

Why? Because selling it would offend his dead father’s pride.
by old-gregg | 2025-07-30 19:47:08+00:00
Fun story time!

Early in my career as a software engineer, I developed a reputation for speeding things up. This was back in the day where algorithm knowledge was just as important as the ability to examine the output of a compiler, every new Intel processor was met with a ton of anticipation, and Carmak and Abrash were rapidly becoming famous.

Anyway, the 22 year old me unexpectedly gets invited to a customer meeting with a large multinational. I go there not knowing what to expect. Turns out, they were not happy with the speed of our product.

Their VP of whatever said, quoting: "every saved second here adds $1M to our yearly profit". I was absolutely floored. Prior to that moment I couldn't even dream of someone placing a dollar amount on speed, and so directly. Now 20+ years later it still counts as one of the top 5 highlights of my career.

P.S. Mentioning as a reaction to the first sentence in the blog post. But the author is correct when she states that this happens rarely.

P.P.S. There was another engineer in the room, who had the nerve to jokingly ask the VP: "so if we make it execute in 0 seconds, does it mean you're going to make an infinite amount of money?". They didn't laugh, although I thought it was quite funny. Hey, Doug! :)
by ben_w | 2025-07-30 19:47:31+00:00
> About one Israeli was killed for every three Hamas fighters on Oct 7, and it's not an exact comparison for many reasons, but hopefully it provides some perspective.

During a surprise attack.

The conflict that was started by Oct 7, according to Wikipedia, has seen 81,526+ dead on the Palestinian and associated side*, vs. 2,053 on the Israeli side.

That said, from the point of view of your edit: the ratio is irrelevant when someone's convinced they're facing an existential threat. Given Oct 7 was proportionally worse for Israel than 9/11 was for the USA, and the USA didn't seem to stop justifying everything through that lens for about a decade afterwards… it's going to suck for everyone that Israel thinks is so much as looking at them funny. (That isn't a joke even if it sounds like one: the people who see Israel as their home and their safe-space are collectively likely to be hyper-vigilant, to their own cost, in this kind of way, for a long time).

* With the footnote that '"Indirect" deaths may be multiple times higher' and 'In addition to direct deaths, armed conflicts result in indirect deaths "attributable to the conflict". Mortality due to indirect deaths could be due to a variety of causes, such as infectious diseases.[27] Indirect deaths range from three to fifteen times the number of direct deaths in recent conflicts.[28] In Gaza, estimated 51,000 natural deaths, natural death rate has gone up from 3.5/1000 to 22/1000 (late June 2024)[29]'
by carlcoryell | 2025-07-30 19:47:49+00:00
The combination of daily weigh-ins and the exponentially weighted moving average I learned from the Hacker Diet has been absolutely magic for me. It gives me helpful daily feedback signal in the noise of ~5lb daily weight variation. Beeminder has replaced paper graphs for me. Their new moving average isn't quite as helpful for me, but is still workable. I target rates of weight loss on the order of 0.35-0.50lbs/week.
by joshvm | 2025-07-30 19:48:17+00:00
For ACH, it's the scheduling and batching that makes it slow. The transfer itself should be instant but often my bank sends it out around midnight. This is why Venmo and Zelle are so popular. You can also modify/cancel a bank transfer before it goes through, which is nice.

This is the same in Switzerland. If you request an IBAN transfer, it's never instant. The solution there for fast payments is called TWINT, which works at almost POS terminal (you take a picture of the displayed QR code).

I think BACS is similarly "slow" due to the settlement process.
by ivape | 2025-07-30 19:48:26+00:00
Yeah, I get you. It's just ...

https://youtube.com/shorts/MuPfkxQns1k

I'm having a hard time being nice. What are people supposed to think? We're supposed to walk away from stuff like that and go "yeah there's two sides to this, we should reserve judgement"? There's no two sides to this. Israel over-corrected after Oct 7, the same way America did after 9/11. They destroyed a city, and then funneled it's citizens into a ghetto in the south. Those. Are. The. Facts. I just provided you the definition of ethnic cleansing.

Also, labeling a human as manipulative is not de-humanizing. Manipulation is a property of a human. It's just a matter of how egregious it is, but you won't escape it. Five year olds will manipulate. You've done it, I've done it. Me and you are doing it right now, but we try to do it in good faith and limit it to just persuasion in discussion. It's a spectrum. Some people are using the ability to justify a genocide.

There's a form of normalization that occurs with egregious manipulation (serious manipulation is abuse, so we normalize abuse). For example, it is becoming normalized to discuss two sides to a genocide.

There is the genocide on one side, and then the normalization of "well, what is a self-respecting nation that wants to defend itself supposed to do otherwise?". The whole construct is part of the manipulation. I'll give another example, Rogan normalizes a lot of heavy right-wing opinions around, well, normal discussion. It'll be embedded inside of a discussion about pop culture. This is a very very troubling form of it. It almost makes you think it's "normal" to entertain the absurd extremes. If you were to confront either of them about this normalization, they'd stay consistent and give you a normal response:

Rogan: Hey, I'm just a comedian!

Israel: Hey, just defending ourselves!

As if the rest of us are literally retarded.