skysight-inc/HackerNews huggingface dataset:
The problem isn't that no one reads generated codedoc, the problem is that doxygen is a pretty abysmal code generator.

If you look at other languages, automatically-generated code documentation has become the main way people ingest documentation for software projects. Javadoc was the first major such tool; if I'm trying to use a Java library, I don't read the source code, I start by reading the generated documentation. If you've ever used https://docs.oracle.com/javase/8/docs/api/, you've used the results of Javadoc. Similarly, Rust also has a widely-used builtin documentation tool (and again, the official standard library documentation is entirely the result of rustdoc).

C/C++ of course don't have a builtin tool. Doxygen attempts to fulfill that same gap, but it also suffers from trying to support every language under the sun, as well as the inherent issues of C/C++ (the use of the preprocessor to generate module boundaries does not make for fun processing). I also find that the default settings tend to make too many graphs that aren't really useful but take up a lot of visual space (I've never found collaboration graphs to be helpful), and its approach to trying to figure out what things are types gets pretty sketchy (why does it think that unsigned is a class?). To top it off, I was never impressed with its design aesthetic.

In short, the fault of doxygen is that it's not designed in close integration with the language parser to ensure a highly correct understanding of source code, which makes it tend to fall over if anything is moderately unusual or confusing. And since the general experience with its output tends to be negative, there isn't much effort in trying to maintain quality documentation comments in the underlying code in the first place.
Thanks Dad
There is nothing that prevents you from putting after-tax money in a regular Vanguard fund? The tax advantages option are just gravy.
This is a really interesting point to think about. I've considered this before: if there were some world superpower with an unstoppable military and a "good" political system, would it be right or wrong for them to take over the world and enforce their (good) policies world-wide?

Obviously, there would be a lot of war to be waged, even if they're all fairly short. But assuming the superpower is truly benevolent towards its people, would it be a morally correct move to look at the long-term and choose to "save" people from countries with less rights, rather than leave them to suffer an indeterminately longer amount of time? So far I'm not sure that either point of view on this is particularly convincing.
It's not just updates. Having to install a one-time use app to book an airline or hotel reservation is a dated concept.
> I'm not sure who a politician would talk to if they wanted to be pro developer.

This is part of my point, I can't think of any organization, no matter the size that is "pro-developer" this can be anything from advocating for the removal of non-competes, codifying some open source things into law, IP law reform, tax write offs for things like accelerators.. anything.

> I'm not sure who would give you money for being pro developer.

Developers would! Being a developer in America puts you firmly in the upper middle class nationwide. I think the nature of most developers is to organize in more decentralized and informal ways. IRC, mailing lists, github orgs, etc. At some point though we will need to realize that we are apart of the mainstream (our companies definitely have) and that there is a voice and mechanism of action to exert that voice to affect things.
> Turns out that the IR sensors on the vehicle saw that a jogger behind a wall of hedges was about to enter the intersection to cross while jogging.

Some cars today already have IR sensors (night vision systems) installed in them, and include pedestrian detection monitors as well. Cars don't have to be full on self-driving to have a large increase in safety and accident prevention.
> You can't build housing cheap enough for chronic drug users to afford.

You certainly easily can: effectively free (subsidized by tax payers).

The house-the-homeless programs run during the Bush and Obama administrations dramatically reduced chronic homelessness in most of the US, pushing it to a record low per capita.

San Francisco is one of the wealthiest places on earth. They intentionally choose to allow the human rights violation of mass, particularly chaotic homelessness to continue in the city. Morally they own it, period. There are obvious, highly effective solutions that have been used elsewhere.
I grew up in the city.

To be fair where Twitter is located, and that Sixth street corridor has literally been one of the worst ares of the city for years. Because of that there's a large number of drug rehabilitation, mental health, and community services that are in that area to be close to the population they serve and to take advantage of some lower rents. The flip side being that it also draws in a large population of the homeless seeking those services.

TLDR - Twitter chose to put their HQ in one of the worst parts of town.

Other interesting note, San Francisco has always distributed their low income housing and services across the city unlike some city's with concentrated neighborhoods of low income housing/projects.
I've seen this curt analogy a lot in this thread, but I haven't seen anybody explain how it's comparable.
> But when you go home after work, also be prepared to see the dystopia that your industry has created as a by-product.

I think it's a bit narcissistic to believe that tech has somehow caused all of SF's problems and unique qualities. Healthcare is a bigger and faster growing industry, and the homeless situation is caused by lots of factors both supply (zoning/regulation) and demand (tech/finance/healthcare workers).

There is a veneer of tech-induced culture in SF, but the true character and complexity of the city is caused by much, much more.
Well, I'm aware of at least one company based in Texas trying to supply homes not just in Texas with solar.

https://www.sunnova.com/

https://www.crunchbase.com/organization/sunnova#section-over...
When I make a sandwich, I do not become a bread baker first...

It is perfectly reasonable to state as fact that the predominant economic paradigm of the city has caused dystopia, despite there being other causal factors or caveats baked in.
It's much easier to design and build on flat ground, especially at scale. Things like road grids make sense, and designs can be spatially translated without custom geotechnical work per site. It also makes it MUCH easier to stage construction equipment and materials.

There are people willing to pay the design and construction premiums for a hillside location, but they are not buying developer houses :)

Also, the lawns provide a water buffer that's essential for managing stormwater runoff. The more densely paved a city is, the more likely it is to flood catastrophically when storm sewers overload. Which isn't a problem in SF though
How do you define "entertainment value"? It's going to be different for different people. I enjoy video games, spend money on them, and have played some for a couple hundred hours I'm sure. But personally there's not a single one that I would take over my favorite albums, movies, or books.

So while there is a greater value per hour of use for games, that does not necessarily equate to a "better entertainment value" for all users.
> I wonder how fast it could have been done if they shut down 101 entirely on that stretch.

I worked with a contractor for Cal-trans 25 years ago. I'll give you an answer.

One month.

That's how long they said an overpass takes if you pre-stage everything and then shut the freeway down and work 24/7 till done.

They also say everyone just deals and local businesses don't go under when business slips for a month. But there is a lot of economic damage when construction goes on for years.

Edit: Old SF native mentioned to me that West Oakland went under during the BART construction because people couldn't get to their jobs for years. And the Castro switched from a working class neighborhood to a gay neighborhood because workers had trouble getting across Market. Workers left, gays moved up from Polk St.
So true. I find it hilarious that the same people who want open borders want techies out of the Bay Area. They’re literally arguing for immigration in the form of open borders while simultaneously arguing against it by demanding techies (aka immigrants) leave their city.
Actually most studies agree with my experience. You can cherry pick some that don't but ultimately if people have the perception that X dog makes a good fighting dog, they train them to become a fighting dog therefore skewing the stats. It doesn't matter what dog you start with, you can make a golden retriever a viscous killing machine if you're abusive or encourage violent behavior, which is also abuse.
Uber loses dispute over arbitration clause, opening door to driver class action
One Day in the Life of a Reader of the New York Times (N. Chomsky)
Are you paid for playing with LEGO?
I'm curious, why do you believe Trump's decision to withdraw from Syria is a good one?

I support the eventual withdrawal from Syria, but packing up now will place a large burden on Kurdish minority groups in the region, who deserve better. It will not be the first time we supported the Kurds while they advanced US goals and then pulled out ASAP.

It also seems the decision was motivated by conversations between Trump and Erdogan, which makes me think the Turkish will resume subjugating Kurds in the region when US exits.

I think we should withdraw by replacing more and more guns-and-boots people with books-hammers-meds people.

Leaving a power vacuum to be filled by Turkey or Russia seems to be the worst option, and imo a betrayal to our Kurdish allies who would not be treated fairly under Turkish or Russian control.

Edit: I really mean this question in good faith. This is my present understanding of the situation, but I do not believe I have the whole picture. I really appreciate the time anyone could take to point out an inconsistency or misunderstanding.
Beyond the United States---these "tax evasion schemes" exist at the boundaries of international law. That's why they continue to survive despite lack of popularity among citizens---no nation wants to blink and close the loopholes, risking the multinational companies will pull up stakes and take their jobs and tax base to the "competition" (in this case, other nations).
Washington Post seems to be a lot better about being a neutral outlet with quality journalism. Although... being owned by Bezos makes me wonder how long they can remain that way.
Donald Trump – AI Voice
Then change the rules.
Huge relief.
It's obviously a joke. M and W on round doors in a location with not obvious up or down direction...
Unfortunately Twitter HQ is pretty much ground zero for more or less the worst part of the city in terms of homelessness, etc. But, really, a lot of visitors don't get a great look of SF given that most of the Moscone area isn't great. There is actually some nice architecture scattered around the financial district but you mostly want to go north or northwest to get to Nob Hill, Coit Tower, areas with a lot of Victorians, etc.
> I can’t help wondering though that the only reason Silicon Valley and the Bay Area has been so prosperous is because it’s in a country where generally people are comfortable with having so much wealth, while having so many people live under the poverty line.
By global standards, yes.
This attitude seems inconsistent with your other recent post:

> some of the world's biggest companies which have absolutely failed at anything resembling civic duty.

https://news.ycombinator.com/item?id=18771628
If you choose a rotary phone, do you still curse people with 8s and 9s in their number as you dial?

Yes. But mostly on the office phone because it slides around if I dial the numbers oriented toward the left side.

Telcos used to intentionally give people low digits to keep dialing short. The abandoning of that notion is palpable when dialing rotary today.

I wonder which actually used NANPA number is the longest to dial rotary under the current scheme.
Especially in Python applications I tend to try to write code that you can read top to bottom like a text and figure out what it does. This is largely destroyed by using an external documentation tool (whether that's Doxygen or Sphinx is irrelevant), because those only extract a very tiny and fixed amount of information from the code. Some docgens even reorder entities alphabetically (by default), which is basically heresy.

I think it would be very interesting if e.g. Sphinx were able to generate pages where the highlighted and crossreferenced code is interleaved with the processed markup from those parts it extracts today (docstrings etc.). Heck, even being able to just tell it to only generate the source code pages and crossref to those instead would be better for documenting applications.
curious who you think you are writing this to. You like free voice? What do you think about hate speech?

Youd be surprised how much closer America is to your situation than to any type of freedom.
But people don't play all games, they play games they like.
This is something I've been working on a bit myself.

Figuring out which files change is relatively easy (as you've demonstrated). Figuring out what the impact of that is quite hard in non-compiled languages (tools like Maven, Buck, Bazel, etc do this well for compiled languages). I.e. In a repo which is primarily JavaScript, I can get the list of changed files, and hopefully have unit test files which are obviously linear to those. However, knowing if these are depended on by other files/modules (at some depth) is much harder. Same for integration tests -- which of these are related?
Why not? I've seen it asserted multiple times in this thread, by multiple people, that these tax strategies are an inherent bad, but I haven't seen explanation as to why.
I switched from a Nexus 5 to an IPhone 7 and I am extremely happy. I like the hardware and software integration. I like the better battery life. I like that I can turn off all notifications from a single menu. What I like most of all is the consistent interface. I do not like to learn how to use a new interface on every release. Nokia use to be great with this in the early days before touch screen phones.
Maybe it would be a good idea that all EU countries have a periodic referendum on EU membership. If a rich and powerful country really wants to keep a smaller, more troubled country in the union, they will have to make it worth it for the citizens of that country. It would improve the balance of power and integration in the union.
The purpose of it being a Medium post is so you can instantly see what he's talking about.
Houghton Mifflin Harcourt | Onsite in Boston, Chicago, Montreal, and Dublin | Full Time

We are [HIRING] [FULLTIME] in Dublin, Boston, Chicago and Montreal all levels of engineers, here's a quick vid/post about HMH and what we do: http://bit.ly/HMHHiresEngineers you can email me directly too: greg.hawkes@hmhco.com

Our main platform is React, but strong skills in javascript, angular, node, as well as others are things they talk about.

Jobs Link:
https://careers.hmhco.com/
Sounds interesting. Out of curiosity, what company do you work for?
At Mozilla, we started with a monorepo, then went to a mostly-monorepo, then consolidated just about everything back into a monorepo, and have since "decayed" a bit to a mostly-monorepo.

There were major gains from merging our source tree with the continuous integration support code and configuration. We've pretty much always vendored selected third-party code, so that didn't really change. Large collections of tests and their infrastructure have been much easier to manage as part of a monorepo.

Given that our tooling efforts are mostly in handling a monorepo, I can't really judge how differently things would be if we had gone full multirepo -- my experience with multirepos has been pretty awful, but that's an unfair comparison since we intentionally haven't worked on tooling for it. We solved our worst multirepo problems by going monorepo, but I'm sure other projects have solved their worst monorepo problems by going multirepo, so neither really proves anything.

The push for separate repos these days mostly comes from social reasons -- if you have a separable piece and want external contributors, that's a strong motivator for putting it on github since that's just Where Things Are these days. No matter how good your tooling and issue tracking and whatever is, even if it's far superior to github's, it doesn't really matter. People have to learn yours; they already know github's. I don't particularly like github's workflow, but I still use it.
Very nice, I've been volunteering in a group, we've been teaching Scratch to kids from 7 to 12. Can't wait until I show them this

Is there any significant difference between TIC-80 and PICO-8? both looks awesome to me
Sure: try to avoid the phone getting hot; don't charge the phone when it's hot; and definitely don't use the phone while it's charging if doing so causes it to become hot. Problematic phones are probably tuned to close to the physical limits; so "retune" manually: disconnect the charger before it reaches 100% (even a few percent matter). Never use quick charging on phones that are living near the edge like this (or accept that each time you do you're doing a little damage to the cells, so use it sparingly). Similarly, don't run the phone completely to 0% charge. But also don't recharge constantly after each tiny usage.

It's much harder for users to do this reliably than for the battery controller. Damage is maximized when all factors align; that's e.g. why controllers automatically turn of quick charge for the last few percent; similarly you can get away with violating a few rules without too much damage as long as you don't violate them all.

Finally, 0% and 100% charge are nebulous floating concepts. What you're really guessing at are the voltage levels in the cells - but again as a user it's kind of hard to guess those in a simplified UI. Is 95% worse than 5%? Typically high charge is worse but... who knows, without knowing what the controller actually interprets as those percentages.

I've never looked, but I'd be willing to bet you can find software to do most all of this automatically on a rooted android; to what degree you can automate care on other platforms - I'm not sure.

But again, the whole situation is mildly idiotic: all of these things the battery controller/OS can do too, and probably better that any user. There shouldn't be a need for much user handholding. The only thing the OS really can't do is choose for you when you're willing to accept a small amount of damage for a temporary dash of extra charge or quicker charging; a feature that by default kept your battery in "care mode", with a temporary toggle to charge more quickly or to a higher level.

A quick google find stuff like https://batteryuniversity.com/learn/article/how_to_prolong_l... and research articles such as https://www.nttdocomo.co.jp/english/binary/pdf/corporate/tec... and http://publications.lib.chalmers.se/records/fulltext/249356/... and https://res.mdpi.com/batteries/batteries-02-00013/article_de... - and I'm sure there are hundreds more. It's not too hard to find info on Li-ion battery degradation, but it's a little much to expect even expert users to actually do much about it (IMHO).
I didn't make that justification. Following laws is considered ethical though, because laws are the ethics of the society that they apply to.

It's fine if you have personal ethics that are different, but that doesn't automatically apply to everyone.
About half of these aren't specific to polyrepos.

changelogs, reproducible builds, code review, signing, grouped components, distributed builds, TDD smoke test, standardized languages, and microservices are all possible (and just as easy) in monorepos.

You no longer need to worry about versioning, which means no manual updates of either your package or updating dependency versions. Although access control is more difficult, that doesn't seem like a good enough reason to make this kind of decision.
Show HN: Your best source to find & hire an A-list copywriter
> to prove the block wasn't generated prior to the newspaper's date.

The newspaper could go back and change the title in their archives. Single point of failure. Tsk tsk. Should have picked a newspaper that stores their archives in an immutable blockchain.
How much of that price comparison is driven non-direct factors?

In other words, is it a function of efficiency in project management or cost-of-living?

Simple comparisons can hide a lot of confounding factors.
The use of a relay is something less than "stunning" and "brilliant". The use of relay satellites when ground stations do not have line-of-sight to the primary spacecraft (or, when you have reduced bandwidth or other restrictive conditions) is standard practice. This concept is used to relay telemetry from Mars landers, for instance.
>The problem would then become people using their corporations to make all of their purchases. Their corporations would own their yachts, their houses, their cars, etc.

This is illegal.
ok this looks better, I just submitted my application, it says its under review. thanks for helping out!
Off the top of my head: Carmack, Sweeny, Rami Ismail

Could probably come up with many other examples. As someone who did dev in that industry I knew plenty technical people who had a outsized impact on gameplay, tone and style.
Acetaminophen reduces social pain: behavioral and neural evidence (2010)
> who pays for it? Existing residents?

Yes. That's how urban living works. Current residents pay taxes, those taxes are used to rebuild/enhance the city infrastructure, which brings in more residents and more tax revenue.

And I think increasing the capacity of the sewer system is sort of an assumed point when it's literally a requirement for increased high-density housing.
I think traditionally you're right, but I'm noticing a sea change. With tech companies becoming more diverse I think you're seeing a break in the cultural stereotype of developers: the google walk out regarding sexual harassment is marker to me.

More people who break the stereotypical mold are moving into engineering, I think this trend will lead to the rise of something resembling a union and special interest groups.
Consensus looks a lot more like 66% than squeaking past 50%.

You are vastly underestimating the number of Americans who do not think like you do. All other things aside, that's going to make politics (and the necessary work to change laws you disagree with) difficult.
Turns out there are lots of different kinds of graphene, and despite all the hype - the demand for the kind we can produce at the current prices - just isn't that big.

As I recall, this is because what can be produced at scale today is, to speak, crap. Authentic, reasonably pure, graphene has all sorts of amazing properties when created in labs but you have these companies producing more or less junk that doesn't get any larger-scale production going. In ways, "starting a company" to produce graphene now has been the source of a lot of the problem. Scientists attempting to apply graphene results wind-up buying junk graphene and failing.

The point of large scale state investment over time, not dependent on immediately making money, is to get beyond these problems. There's the risk that even a lot of spending won't get you a way of producing good graphene at scale - well that's the risk. State finance is all about being the way such large-scale risk can be taken.
>Can't redevelop lower Manhattan because everything between Houston and 30th is a "historical building".

Are we now considering "lower Manhattan" to be south of 30th?
Venezuela’s Lessons for American Socialists