skysight-inc/HackerNews huggingface dataset:
Ask HN: What software documentation tools do you use (for JavaScript codebases)?
We have a half dozen or more git repos, each with a README.md file. Some of those repos contain front-end JS libraries or apps, in which case we use JSDoc to generate the documentation for that repo. Other repos represent a particular system, and contain numerous microservices. Each microservice has its own README.md. We also have other markdown files containing coding standards and other documentation that's not specific to a single project.

We need documentation at several levels: the codebase itself (mostly JSDoc), the individual library or microservice (mostly the README.md explaining that library or service), but then also at a higher-level: how do all the services in this system (repo) tie together and interoperate? Or, in a separate primarily-docs repo: here's our coding standards, official policies on things such as security, etc.

Ideally we'd have a tool that we could run on our CI server that builds docs from each of those repos and exports the docs as a static site. We'd also be able to easily link between services and code across codebases.

I've looked at / tried Sphinx, but since we are primarily JS / Markdown, it would be very different to try to use it for our projects, and the sphinx-js integration was lacking (couldn't really replace our JSDoc builds). I've tried a number of static site generators (e.g. hexo, hugo, etc), but they tend to be more about sites and blogs, and don't seem to work well for documentation.

What do you use?
'Suspicious' BGP event routed big traffic sites through Russia
From my perspective, the positive to this is that it will incentivize tech giants to accelerate the development of the web platform (WebRTC, WebGL, Web Assembly, Web Torrent and the like) as stuffing everything in HTTP and using encryption will protect them from the dirty blocking of services, and will allow them to focus their efforts on fighting throttling. For this reason, I hope Comcast and others will scare the hell out of them and do some big time media-covered dirty throttling.

I can already see for-a-better-web.org where Apple, Microsoft, Google and others explain why they have finally decided to move their ass and get serious about implementing the modern web in their browsers. With their level of funding, the time all of this is taking is ridiculous. When Netflix and YouTube get their first bill from tier 1 providers, Web Torrent and libtorrent will receive a pull request within a week and chrome will be patched overnight.

I do not think that the small guy will be hit by these rules, mostly because I think that by the time it comes to that, politics will have changed. The end result will be that everybody will benefit. Implementing the modern web seriously is the one thing that web giants can do to protect themselves, as it would enable a fully decentralized web. The difference between that and NN is that the modern web would actually help the small guy by making it easy to for example start a decentralized YouTube. So it's easier to cry fool on NN, and look like you're concerned about the small guy when in reality you too are concerned about protecting your interests in the most convenient way possible.

Not saying all of this is a conspiracy, just saying tech companies are far from being disarmed, they also have their monopolies they want to protect. Keep it in mind before crying over this vote, or spending money and time on volunteering. Let Tier 1 dudes give them the hardest time of their life and watch. If it gets to hitting the average Joe, do something but my take is it won't have the time to get to that.
Self-hosted could mean running on a rented server managed by a vendor (e.g. Rackspace) often marketed as a "private cloud." The servers they're using are individually assigned to that client, the vendor manages the physical, the company manages every other layers.

Self-hosted on bare mental usually means the company owns the physical servers, storage arrays, and so on. No renting or leasing. No subscription fee-like service. They may still be renting space in someone else's data center, but it is their hardware.

The distinction isn't super important to be honest.
Love letter? Hmm, that annoying glossy display?

I hope they will fix the new macbook pro, that would be a love letter!
Yes absolutely, but it's not really a problem on the commercial market because there's enough competition there.

In my small city in Michigan, for example, there's exactly one phone company and one cable company for residential uses. But there are 4 different local companies selling commercial bandwidth backhaul, in addition to nationwide major providers like Level3 and AT&T.

If you're somewhere truly rural, this can be an issue, the local monopoly might not let you buy commercial (re-sellable) bandwidth. But in most cities -- even small ones, it's probably not a major issue.

At the moment, commercial ISP services are still somewhat competitive. It's the residential ones that are completely monopolized.
They just announced another increase the other day, what caused that?
I have been instantly closing the Facebook app or Facebook page as soon as I get any type of video ad. I feel like some ML algo will learn that I will not watch video advertisements so eventually it may stop trying. This will make it so I will not watch videos at all on Facebook anymore.
You don’t need to worry about that stuff with someone like IBM SoftLayer and a bunch of other professional unmanaged/semi-managed bare metal.

E.g. WhatsApp have been on SoftLayer for a long time and are still there many years post-acquisition.
Double-prec. int mul. with a quad-prec. result from single-prec.mul./quad result
Agreed. That's why I made my earlier comment, that this is closer to your entering a store (not just looking in the window) and examininb the merchandise after you already had been sent away for trespassing, revoking all authorization.
> all the basic stuff that you would expect to be there seems to work.

Basic stuff is there, yes. But compare it even with a GIMP is a joke.
"In a bureaucracy, it’s easier to make a process more complex than to make it simpler, and easier to create a new burden than kill an old one."

He should have lead with this.
Here's an example of the structure of our repos we'd want to document: https://gist.githubusercontent.com/anonymous/f88e2917b5513c2...
I think agricultural collapse is a great place to start researching. The book 1493 all about the ecological exchange of contact with the new world has some phenomenal perspective about it all. Our high input monocropping is pretty tenuous. Look at the lifespan history of commercial pesticides and fungicides, they used to be 30+ years around the turn of the century. Today, a newly discovered pesticide has a lifespan of about three years before it becomes not effective. The extreme lack of genetic diversity in our crops is a time bomb waiting to happen. If you think the Irish Potato famine was bad, it's going to be a mere footnote to the kind of agricultural disasters we will see come out of the next century. Rubber trees are a particularly vulnerable piece, 99% of all rubber produced in the world comes from southeast Asia from a handful of clones brought over from the Amazon. They can't monocrop rubber in South America because of leaf blight. Yet when that blight makes it over to se Asia on somebody's boot, things are going to get weird fast. No rubber means no industrial hoses, gaskets, and tires. We don't have any economic means to reproduce natural rubber. All the computers in the world won't make a difference.
You don't even need to be a name brand to get discounts.
Last I researched, the land ice was melting a lot, but then refreezing a lot. It seems that sea ice is the main thing disappearing.
I would think that is simply the statement that the ordering of timestamps preserves causality? What the "actual point in time" of anything is isn't really relevant--the question is whether you can show that a given transaction started after another committed, and if so, then you are guaranteed that timestamps assigned to those transactions preserve that ordering.
Yeah you definitely have bigger problems than net neutrality. I'm in the middle of Africa, 30km from the CBD of a small city, and I have 1gb local / 100mb international fiber with no caps or throttling for the equivalent of ~$85/month. Plus I can WhatsApp the tech support if something goes wrong and they'll drive over and fix it within 30 mins or so.

I also have a choice of about 8 different ISPs offering me fiber lines to my door who seem to be in a price war with each other at the moment.

I don't have net neutrality though. But surely the problem you're facing is ISP/government monopoly related, not the net neutrality bit? Or do you think it's something else causing the ISP issues there?
The Rebirth of Pro-Natalist Public Policy in America
Comments like this and your other one at https://news.ycombinator.com/item?id=15925935 are so interesting to me because the opposing comments are so similar: https://news.ycombinator.com/item?id=15752730, https://news.ycombinator.com/item?id=15307915, lots more at https://hn.algolia.com/?sort=byDate&prefix&page=0&dateRange=.... From my perspective it brings out how much the people at the poles have in common. (That's not an argument in favor of the ideological center btw; if you think that kind of averaging is dumb, I agree. The way out is not so easy.)

> Definitely couldn't be related to his relationship with Peter Thiel

You might have the arrow of causality reversed there. Also, please don't lash out personally. It's true that public figures are just cartoon characters in most people's minds, and you don't owe any better to cartoon characters, but you do owe better to this community if you're commenting here.
Facebook has become almost completely useless to me yet I waste so much time on it every day. No one posts anything on it except like 3 guys who post 10 times a day that I barely know yet find their extremist political posts mind numbingly amusing. The news on there is trash, I much prefer the WSJ and if I want sensationalist things I'll go to Reddit and my tastes are more niche now so I have some forums I visit occasionally for better discussion.

I have never in 10 years clicked on a single ad and I've removed the apps so I don't get autoplaying videos so I'm not bothered by the future ads on there. Messenger is important to me and the Birthday list is too. Without those I wouldn't deCtivate since you need it as social proof for Tinder, but I'd never go back on.

Honestly, I was busy for just 3 days and didn't log on and the "addiction" completely vanished. We need to have a no shave novemebr for Facebook, maybe a no Facebook February and I guarantee millions would get off the addiction and vastly limit daily social media use.
"solo science gods make great advances" is not at all what "E Pur Si Muove" means.

It means that the material world is what it is, and that reality is not modulated by human decree.
Not in Hong Kong, Tokyo or Seoul.
>We wouldn't have services like Netflix or Facebook or Google if NN had not been in place.

I'm astonished at the FUD I've seen recently over NN.
Netflix, Facebook, Google and the rest of the internet predated NN. NN started in 2015.
No, actually it's not. You can pay for a better connection yourself, but "paid prioritization" essentially slows down other people for the person connecting to you, through no fault or issue of theirs.
Bryan Caplan wrote an interesting book, Selfish Reasons to Have More Kids, that is also germane to this topic (https://www.amazon.com/Selfish-Reasons-Have-More-Kids/dp/046...).
You are working on an assumption that any charges would be based off of usage in a logical manner.

In reality Netflix might offer to pay a little more to comcast if comcast is willing to up the costs on their competitors, or other such arrangement. The problem with removing NN is that we're inviting oli/monolopy forming to occur, which the free market cannot deal with.
Ever heard of the Supremacy Clause?
Fun site! It's a bit annoying that you can't edit the input and get a new result though.
Correct. I've seen their cages.
No. Intellectual property is the real issue here because this is what allows Disney to do these things.

Whatever your intention you used a populist argument that anti-market people have used for 100s of years, and given that there huge numbers of companies still in existence that argument should have been disqualified by now.

Just stopping a merger does not change the underlying structure and will accomplish little.
hate to be the bearer of bad news, but there are something like 400+ drugs that have prevented type 1 in mice and another hundred or so that have reversed it. none have worked in people

the most common animal model for type 1, the NOD mouse model, is notoriously bad. studies have shown that loud music cures diabetes in these mice. mice raised in one lab get diabetes differently than mice raised in another. the immune systems of these animals are very fickle and almost any environmental perturberance can change an immune response
But how much does it actually change the albedo? Are there hard numbers and analysis? Most of the sea ice is below the surface, so a lot of sea ice melt does not necessarily translate to a large change in albedo.
Bitcoin and peer-to-peer networks (2011)
Yeah. The exact same thing happened at Evernote. They hit a sales slump, new “corporate” management, cuts etc -> GCP.

The Ops people there were pretty proud of their infrastructure, but they took it to a pretty extreme level. I think they were racking their own stuff and even running their own routers etc.
Facebook Messenger Retrospective 2017
Veldrid: a modern, cross-platform 3D graphics library for .NET
Found some interesting contrasting statements from 2015 [1]:

> The company performed big data jobs early on in the cloud, using Amazon's Elastic Map Reduce service.

> “That [EMR] got us to a place where we think about what data we collect. At the time it was really inefficient from a cost perspective, but there weren’t any creative constraints,”

> The team eventually decided to bring it in house. “Our Hadoop cluster wields a huge amount of flexibility," said Rembetsy. "We can get a lot done on bare metal, and we know very much what we’re looking for. Cloud services, that’s where efficiencies fall away. Spin up and spin down doesn’t have the same value proposition.”

[1] http://www.datacenterknowledge.com/archives/2015/05/11/how-e...
Why is sexual differentiation necessarily costly in every case? There are many sex differences that give an advantage for one gender that would have been an advantage, or no cost, for the other gender, but weren't as strongly required and so don't exist. Sexual differentiation may be less _likely_ for any given trait, but traits tend to pop up on random chromosomes, or the side effects of sex hormones be farther-reaching than necessary and evolution just "didn't bother to correct," and so I'd expect that some traits that don't necessarily need to be dimorphic (but are needed by one gender or the other) might become dimorphic just by chance.

Men have deeper voices than women. What would be the disadvantage for baritone women? You could argue that a deeper voice makes you less easily heard by prey... but then what's the advantage for women to have a higher pitched voice? Why didn't we all continue this trend to speak at the registry of blue whales? I suspect it's one of those things that "just sort of happened" and then it became a positive feedback loop spurred on by sexual attraction as a result of this initial differentiation, and now we're just at a pretty good state spurred on by a combination of random chance, survival advantage, and a little reproductive enforcement.

Increased sexual dimorphism (and a genetic/hormonal configuration that lowers the cost and increases the odds of sexual dimorphism happening for any given feature) is actually a positive thing for some animals depending on their social and reproductive strategies. When sexual dimorphism is high, you tend to see more random differences that pop up between the sexes but that may or may not provide any evolutionary advantage beyond "well, the other sex is just attracted to it now so let's keep this party going." When dimorphism is low, differences generally have to provide a stronger survival advantage.

Evolution isn't always straightforward or "carefully thought out." The hoops it jumps through aren't always costly and don't always have a rhyme or reason. It's often chaotic and and takes weird turns and it's not like humans are at a "final state" anyway. We're evolving.

I'm not _necessarily_ disagreeing with you (although it's probably ultimately easier to look at the physics, not biology, to prove or disprove your point) but I'm just saying that I think the situation is vastly more complicated than "sexual differences are costly." I don't think they're necessarily costly, simply less likely. A subtle, but important difference.
In tornado alley, poured concrete is a life-saver.

it's also extremely time efficient. 5,000 sq/ft homes' foundations can be fully assembled in a day.

It's unusual for you, but you're also not the target market.

I see it mostly advantageous for full-height/walk-out/live-in basements, though.
I find Google photos to be much better at sharing photos and videos with family and friends. Photos are posted to specific shared albums. People who may care are invited those albums, those that don't care don't accept. They get notified when there are new ones and can make limited comments. I like that it is just a place to share/view photos - I don't need a million other features or distractions.

News - anywhere but FB.

So what do I use FB for? Local groups, the community, yard sale, a few for specific interests. I might check it weekly.
I am not sure if we want to upload our minds... then the robots would be humping each other endlessly and never get anything done.
Cloud providers have to make money, though. You're doing more with bare metal, yes, but you're not doing much more (especially compared to learning how to use a cloud infrastructure effectively), and the cost may not be worthwhile. Generally, the cost of buying and running one server in a datacenter and staffing the ops team needed to keep the hardware running is cheaper than paying for a 24/7 server of comparable specs in the cloud. And if you're already running in a datacenter, it's extremely not obvious that the cost of moving your workload ever will be net profitable.

Of course, if you don't need comparable specs to an entire physical server (I do a lot of personal stuff on a t2.micro!) or don't need the same capacity 24/7, the math is very different. The cloud is definitely cost-effective for elastic workloads.
> Back in the day, it was thought that basic HTML was a format to last.

HTML was never intended to be archival. Archival assumes a long term relationship between format and user-agent, but those two things evolve independently.

> Who is going to update these documents in order to make them conforming to future browsers?

You don't update legacy documents stored in an archive. You find a conforming user-agent (appropriately old browser version) to consume them in their intended state.

> Is it worth it?

Yes, HTML is a versioned format. Improvements to the format are welcomed and necessary.
You can cash out half when it's enough and let the other half grow thousand times or go to 0 without caring.

I have no idea if that happened here.
This seems like a distraction. We don't need green cement, we need laws that allow us to shape cement into tall buildings so people can live near where they work.
I'm not judging it on an experience two decades ago. I'm judging it on an experience 2 weeks ago.
Can’t just be “alt” coins.

Harvest profits and put into multiple uncorrelated premises or theories of how digital value works.
In a data center in Jersey, at least a few years back.
Ever heard of the prohibition? The government had supremacy there too.
Maybe GP was asking is using Tor would circumvent the issue?
Powershell Macro Creator for MS-WORD
But San Francisco is also 33.3% Asian and over 15% Hispanic. The white to non-white percentages are very close between both locations. And while the story of Asian Americans in SF is not the same as Black Americans in the South, it was hardly a picnic for them (for one example, Angel island).
Because,

1. The companies you mention also have a monopoly on internet content distribution

2. Most people are herd thinkers, don't know anything about NN, only that "it's bad" because the content they see says "it's bad"

Propaganda works.
This claims that on close-to-breakeven applications that moving to serverless might reduce dev costs or accelerate dev work... Serverless proponents: how does that work in theory?

In practice, all the serverless guys I've seen have a pre-CI pre-VCS pre-UAT kind of workflow using the AWS console where there's no change control or ability to collaborate.
Compilation of Tweets about intellectual compounding by Sizhao Yang
It didn't happen with TV so I'm not sure the schadenfreude will really take effect.
A quick recap of KubeCon and CloudNativeCon 2017
Sorry, you misunderstand. I remember when it was difficult. Having tried it 2 weeks ago, it should not be as difficult as it is.
IANAL, but near the end he says he'll be including it as a condition to certain things that the state has control over. maybe that's how they get around that issue?
Might have to do with the number of people. E.g. in Spain there are fewer black people, proportionally, than in the US, and a "black neighborhood" is unheard of: black, white, people are just the same culture. Same with Asians and Chinatowns. There are gipsy communities and neighborhoods, though, with a distinct culture. And in France there are muslim neighborhoods, which I haven't seen in Spain nor the US.
Really? I upgraded by Macbook's hard drive and RAM because I can and it was available to sped up the performance, I'm still able to use it up until now and it's an old machine but the upgrade is making it last longer.

I also upgraded my parent's iMac after the hard drive failed and also installed additional RAM to speed up their experience. Those aren't pro machines but day-to-day computing needs.

For this price point I would have expected to be able to do these things, and knowing pros use their machines heavily and rely on it, it's a pain in the ass not to have this ability. Perhaps it's already great out of the box and nothing else is needed, it's perfectly future proof. But honestly, if the option is available to upgrade parts -- I'm sure people would love it more.

In addition -- the commenter above, I'm not bashing on Apple. In fact, I am an Apple stockholder. I am only saying they have failed in many ways to satisfy the customer's needs but instead make decisions now based on the marketing and profit. You can only do that for so long until your supporters start jumping ship. My comment is more of frustration not bashing.
In the US, under the OIO/Title II, an ISP could do basic network management (e.g. blocking ddos attacks, holding people to the bandwidth limits they paid for) and basic QoS, though I'm not exactly sure how that was defined or implemented.
I'm pushing my kids photos to their own Google Photos album. Every once in a while I'll pull down the entire thing so I have a copy. They don't act like they own my photos.
I've just tweaked the page with:

body {
width: auto;
margin: 2em auto;
max-width: 40em;
font-size: large;
line-height: 1.4;
background-color: #fffff8;
}

* {
line-height: 1.4;
}
It's not democratic. It's republican. Remember that America is a republic, not a democracy. Each state has 2 senators/electoral votes because this country was founded as the United States. It was supposed to be more of a coalition of states united under a federal government, than a single nation.

Also, California has a huge population with tons of representatives, and basically every elected official is democratic. I don't think you should complain.