skysight-inc/HackerNews huggingface dataset:
Ask HN: What's your preferred layout for API documentation?
I'm writing documentation for a public (REST) API and wonder which layout is preferred by developers.

For example, Stripe uses a three-column layout: a navigation pane, a column to describe the API, a column with examples and error codes (see [1]).

In contrast, Mailgun uses two columns: a navigation pane and a colum including the API description and examples (see [2]).

Both layouts seem popular, and I'd like to better understand what's making you prefer one over the other. I'm talking about reference documentation, assuming there's also a separate user guide.

Personally, I find the three column layout harder to read: the example pane often wastes a lot of space and squeezes the actual documentation in the middle. On the other hand, I see more and more sites (and tools [3]) using that layout, so that's probably just me?

Thanks for your thoughts!

[1] https://stripe.com/docs/api

[2] https://documentation.mailgun.com/en/latest/api-sending.html

[3] https://github.com/lord/slate

(edit: simplified the layout descriptions)
> Don't you think any kind of challenge in a team setting would have provided the same growth without the side effect of possibly irreversible brain damage?

Different sports are different. I don't think that's hard to believe.

I ran track and cross country for 9 years. Those are team sports but there was no camaraderie. People were friendly, sure, but there was no team spirit. There was more camaraderie in the half a year I spent on a rowing team than I experienced in either of those sports.
> Would the humanitarian cost be less if NATO hadn't intervened?

Yes, that is what I think.
Seems suspicious that, despite having validated my bank account and despite me making no more transactions with it, they demanded more ID Just to get the product I'd already purchased.
Why do you assume that the default is too low? There are obvious tradeoffs here, some analysis would do the coin good.
Gramophone audio from photograph, revisited
Yes, I agree there are reasonable objections to the argument made in the paper. I think it's better to raise those objections than repeat a statement which the article explicitly addresses and dismisses as a myth.
the article seems to be OK with it being voluntary (more or less?). I think it's just making the point that it's immoral not to give it away. maybe instead of "stealing" excess wealth we can just shame it more than we do now.
I think Medium's financial problem is that they aren't charging for their services. My blog is hosted by Medium at my own custom domain, and the only thing they charged me for was the SSL certificate. They ought to charge for that like Wordpress.com does.

But yeah, Medium has some problems and a long way to go, but it has so much potential. One of their problems in my opinion is that most of the articles that show up in your feed at Medium.com have a BuzzFeed like quality to them. They should integrate some sort of RSS functionality into the feed, and start adding all of the best blogs, regardless of whether or not they happen to be hosted on Medium. But that's just what I would do, not that anyone cares ;)

For example, if you follow the "startups" tag on Medium, you ought to get cool stuff in your feed like IndieHackers. They could include IndieHackers and great blogs like it in their feed, and if people happen to click on those stories, they could just redirect people to those sites. So it would be sort of like Reddit, but instead of people submitting links, the editors at Medium would currate what gets added from other sites, and Medium.com users could obviously add blogs to their own personal feeds via RSS.
Considering I trust the average TSA employee about as much as a junky I found on a street corner, no way am I letting my electronics out of my sight. I already take them all on as carry on specifically to keep the TSA from stealing them, moving to a system like this would mean I couldn't travel with electronics (other than the exempted cell phone) anymore since there's like a 25% chance that the TSA will decide to swipe it.
Getting involved in open source
optimiser changes string concat to StringBuilder.
They can start with just the UTXOs, 2GB, and the last few blocks plus a checkpoint.
> "I didn't know app loading screens were "a great feature".

Loading screens are obviously a good thing when lots of assets need to be loaded for a game. The presentation can inform the user where things are at in the process of fetching those items. Flash could do it quite well.

Isn't that obvious though? A loading screen is informative and functional.
Implementing State Machines in PostgreSQL
I'll consider using this platform when they move away from monolithic Ember.
The challenge is that football is inching from "where long-term injury can occur" to "where long term injury does occur". That is, from "If a play goes poorly, you may tear ligaments and break bones, which may have lasting effects" to "it should be the expectation that if you practice and play this sport for any length of time your brain will resemble a block of emmentaler".
> A kid, even at 17, is much less autonomous, will have an educator or foster family, will go to school, etc, they are going to be 'enrolled' much more actively into society.

That's nice in theory, but it doesn't actually bear out in practice. As one example, according to [0], even second or third generations fail to integrate (with disastrous results), and AFAIK that's the rule rather than the exception (though there are quite a few exceptions, more in the UK, less in mainland Europe). It's not enough if even 50% integrate successfully when the number of immigrants is so high.

[0] https://www.washingtonpost.com/graphics/world/brussels-molen...
Mobile Technologies Are Now an Integral Part of Education
It would be super awesome of any of those bug reports included whether or not they are using ECC ram. Occasional segfaults from compilers (which touch lots of ram) could be explained by bit errors occurring in memory.
Right but where is fun in that?? Lol. By the way, I think I should add this part on the post to show the fix, especially for the newcomers in Java world.
I'm curious what makes use 500+ sometimes.
More recogniced just like the Intel bugs on their BayTrail and appraently also the new Apollo Lake(same CPU family).
https://bugzilla.kernel.org/show_bug.cgi?id=109051
- check how old it is...

I have a sad HomeServer (J1900 BayTrail).
NodeJS as a backend platform is still horribly inefficient and years behind mature Python and Ruby solutions.
Depends on where you are from. In super blue Pittsburgh, not a chance on earth. Football will have to be nationally legisated against in order for its popularity to fall in Western PA. I am sure there are other, similar pockets in the country.
(1) Not sure if it's fully the layout but no API documentation I came across was as easy as Stripe's for me to understand. Probably helps that they use "Entities" to describe the objects.
Tips to improve speed of your test suite in Ruby
I've been working on whatever interests me, which tends to relate to programming languages. My biggest on-and-off project, for example, is a tool that compares source code based on parse trees.

My main advice is just to jump into it, and to distinguish problems that you should try to solve on your own to learn faster from purely incidental problems that aren't worth your time. (Conceptual questions and understanding abstractions falls into the first camp; dependency issues and bad error messages in the second.) Especially with the second sort of problem, you can always get help on #haskell IRC, /r/haskell or StackOverflow.
Thanks for adding more fun.
Now you know how Flash developers felt when everyone was saying it was a buggy platform, because so much of the dev community never did active debugging.

I ran the debugger version of the player and would get error alerts all over the web - for things that should have been caught with a try/catch or basic variable checking - even on some of the most prominent web apps of the time.

99 out of 100 times, that was the reason for an app crashing, not the player itself.
I don't suggest putting in enough money to risk insolvency. If you're confident that the decline will happen in, say, five years, then I expect you could buy a few put options and make some healthy profit.
I'm not sure if this is because I'm using a Chromebook, but the HTTPS link to Bulma both fails certificate validation and fails to load CSS. http://bulma.io works fine.

Edit: and it looks beautiful! Thanks for the pointer!
Rob the CTO of Collaborizm ask me anything!
Let's assume people stop mocking this idea and ditch computers for the most recent and highly classified data. Over decades of replacing everything with computers and retiring oldtimers, we probably lost a whole set of skills to run physical paperwork, keep it secure and detect breaches.
> "i ... live on less than $25k a year."

there's no way i can believe that. my rent alone is $24,000.
First of all, upgrades are opt-in, so you can build on top of the OS and only switch to a new kernel version under certain conditions, such as if all parties in the contract agree.

Also, keep in mind that financial contracts are not subject to hacks, unlike smart contracts, as we have seen several times. One of the goals of upgradeability is the possibility to roll out security patches as needed.
> I'm hoping this attempt will go about as far.

Why?
I'd like to move more towards this. And the branding and identification is probably a big part of this. Pushing news to report the culpable parties by name. "Samsung / Google / Apple recently had a flaw in their {model} phone" vs "Another phone vulnerability" desensitization.
Note, latest amd64 snapshots reflect the switch to clang if folks are curious and want to experiment:

> cc -v
OpenBSD clang version 4.0.0 (tags/RELEASE_400/final) (based on LLVM 4.0.0)
Target: amd64-unknown-openbsd6.1
Thread model: posix
InstalledDir: /usr/bin
Why try to dictate what developer tools are available to frequently-used, heavily interactive apps, vs the other types?

> This is the thing – some publishers insist on using their stupid application when all I want to do is browse some content.

That's exactly the problem PWAs solve. Those publishers want some features that on iOS are only available to native apps, and so have to make the experience suck for Apple users by using an installed native app instead of a web app. Both publishers and users have an aligned interest there for PWAs, which goes against Apple's own interest.
I think this makes total sense: Bot engines (i.e., GUIs where you devise complex conversation scenarios) don't really work beyond the quick proof-of-concept project. Their quality tend to actually decrease with the amount of effort you put into training and designing the conversations.

The underlying NLP tasks however are crucial. What Wit is doing here is build on their strength on NLP tasks on a message level, and leave the conversation rules to the developer to code as they see fit.
Dropbox has 2 founders [1]

[1] https://www.dropbox.com/about
As of yet there is nothing remotely close in feature parity and developer niceties to DRF in Node.

Given that there are no tightly integrated monolithical frameworks in JS land, I doubt there will be for a while.
I ran into this guy randomly at MIT once, during the offseason (last February). He was such a chill guy. Hearing this news makes me like him even more - he's not letting one of his passions get in the way of another.
Why would they use Go instead of C#?
An anecdote to support this: not every business I've started myself was successful, but all the successful businesses I've started were without partners. On the other hand, every business I've started with one or more partners has failed.
> Ubuntu is wrong and likewise you are wrong.

Thanks, anonymous internet attorney. This is not an appeal to authority, but when a corporation is willing to put out official communication stating that they have consulted with attorneys whose legal opinion is that there is no violation here, and who has a lot more to lose than you or I, I am inclined to give them the benefit of the doubt.
Man you are forcing me to make another post in my blog. lol. By the way, the way you explain is perfect. Thanks.
If your goal is to be able to plot incomes of a wide variety of people and be able to visually see the difference between poor and average as well as you can see the difference between average and super-rich, then a log scale is the way to do it.

The goal of the comment you replied to, however, is to demonstrate the vastness that orders of magnitude have. It's to compare average people to super-rich, and get a stronger intuitive sense of how much wealthier a billionaire is than the average person, and how much wealthier Bezos is than the average billionaire. Using a log scale doesn't help that goal at all, a log scale actively compresses the range and prevents intuitive physical comparisons & analogies.
Was there historically a way to subscribe to either one of them without also getting the other? The article says you already get Google Play Music for free if you subscribe to YouTube Red...

I did the opposite (and getting rid of commercials in YouTube was a big selling point for my Google Play Music family plan sub.)

Sounds like nothing more than a rebranding (and personnel merge, OK so it's a big deal for the developers, but seems like no significant change for the users at this time anyway.) If a result of this change is that one day, I will be able to listen to music videos on YouTube with my Google Home then I will be happy about it.

(Doesn't work now, because YouTube cast button assumes you also care about the video in the stream. So when casting from YouTube, you only get the option to cast to devices that support video. Even though there is plenty of content on YouTube that has one still frame fixed in place for the entire song! You can still cast the audio from your entire device, but then "next track" voice command is surely not going to work.)
#2 is also genetic. Stamina and attention span count for a lot.
Whoa... I'll never look at my spoons the same way again.
In my opinion, VCs prefer their investments to have more than one founder because teams are generally easier to manipulate / more willing to compromise. Solo founders, almost by definition, are going to be much more gregarious and stubborn. That doesn't equate into investor board control, which can cause issues down the road (see Uber)
> say that an average young person working in retail might have $5K in savings

Doubtful. Even if you assume a minimum wage of $10, which is well above the Federal minimum (but slightly below some state minimums), that's 500 hours of wages. That's almost three months of 40 hours work weeks where you put every penny into savings. Before taxes. Before living expenses. The vast majority of Americans have far less than $5k in their savings account.[1]

1: http://www.cnbc.com/2016/10/03/how-much-americans-at-every-a...
I was just using the price range provided when I google "ferrari price". The number range passed a sniff test so I picked the highest one and ran with it.

Your numbers and sources are clearly better.

Are there even 10,000 of those "hyper-cars" out there to be bought?
Java Thread pools for starters
What about Zen powered laptops? What is holding them back?
Now there's a false equivalence if ever I saw one. I stiff hip or bum knee from playing sports seems way, way different to me than suffering irreversible dementia and chronic depression beginning in one's late 40s.
Interestingly, Python is more "strongly typed" in this sense

TypeError: unsupported operand type(s) for +: 'int' and 'str'
Facebook Joins Harvard in Initiative to Defend Against Election Hacking
I loved Sonic on Master System, Game Gear and Mega Drive/Genesis and was completely thrown off guard when I played Sonic Generations on the 360 decades later ("whoa how can anyone keep up with that pace?").

Once you embrace that pacing (which has been there all the time) you'll be able to appreciate that special kind of game/level design. It seems that Team Sonic was able to apply that principle to Quote a good number of titles with the IP.

Back in the days the controller would have been soaked in several people's sweat ofc and there were no persisted save points.
If you want to improve on persistence, priorities and quick decision making: Go play these games on their original hardware (or at least don't use the emulator's snapshot abilities).
Why would that be embarrassing? You've effectively created your own private AI microservice (to use the buzzword du jour) and consumed it in your favorite webapp stack. Sounds pretty smart to me.
The fact that he put the 'incorrect' in quotes indicates that he likely agreed with you on the use of the word and the you probably missed the intent of his use of it.

Unlike 'bad', a subjective word indicating opinion, 'incorrect' is objective: anything can be incorrect according to a certain set of parameters, and the author is selecting a particularly traditional set here from the book in order to frame the discussion.

He's not implying that Sonic is bad. He calls it a masterpiece!

It's quite likely he's also a Lorde fan.
For anyone here who wants a very well-made nostalgic dive into the art / feel of Sonic the Hedgehog, namely Sonic & Knuckles, I recommend this: https://www.youtube.com/watch?v=DdxQmgC2Bhw
Drew applied to YC (and was accepted) as a solo founder. Not sure when the co-founder came aboard.
that's literally the point of the article.
Anyone knows some light weight Node JS based alternatives to Ghost?
Ask HN: What do you do when you get bored from a “successful” side project?
I'm currently working on a (hobby-)side project that I started last March; It's already functional (since several versions back actually) and even deployed to our company's server where some of my colleagues are using it, since it solves some real world problems. (The legal part is all sorted out, no worries about that part.)

The product is 95% finished (some logging and error handling to do), and thought about turning it into a SaaS product, just to see how it would fare.

The problem is that I got bored. What's supposed to be done in a day, still unfinished a week later. Not because of some nasty bugs, or technical problems. It's just that I no longer that excited.

In such circumstances, what do you do?
There's a difference between a small risk of long-term injury (a risk you run in different ways if you're not doing sports, I might add), and near certain brain damage.

Not all sports have so grim an outlook - and I bet football too could be fixed with some rules changes (e.g. I don't recall any stories of rugby having such effects, and that's at least somewhat related).

Further research can probably help, but it's unwise to wait for that if the results are already sufficiently clear as is.
First, I'd recommend python-future rather than 2to3, it has additional fixers and replaces some with better versions.

Second, those only do the fairly straightforward changes, fixers are simple AST transformations they don't do complex type analysis or anything, you should use them as a starting point but don't expect the work to be over by then: the 2->3 transitions has a number of API and semantics changes which these tools can't handle, text model changes are the biggest one[0] but they're not the only one by far.

If the project is non-trivial, having a good test coverage is absolutely crucial.

Basically, 2to3 handles the first 90% of the work which are mostly drudgery and syntactic fixes, you're still on the hook for the second 90% which is more subtle.

Source: finalising the conversion of a ~200k SLOC codebase to cross-version compatibility.

[0] not just the strict separation of text and bytes, but APIs being set to one or the other so you have places where you want to ensure bytes, others where you want to ensure text and yet others where you need "native strings", some APIs (csv) are also incompatibly altered.
>People never needed technology to commit genocide - there are plenty of examples throughout our whole history.[1][2][3]

Technology was used in all of those examples.

Technology by itself didn't create mass murder, but it does makes it much easier to do.
I have a simpler tactic I don't follow anyone I search for hashtags, so my experience is not person driven is subject driven. I also have a couple of lists that I sometines look at tweets.
He probably owns his home. Most people who own property don't count the imputed rent as part of their expenses.

Whether they should depends a lot on context.
Hard for me to say, as I live in Seattle, but American football love is definitely non-partisan here.

But certain sports carry too high a risk for me to support my child getting into them before 16ish. They must have a glimmering of a perspective on what life means before choosing to engage in activities that are significantly likely to permanently damage themselves for life. Particularly for football, there are brain effects. Implication here: for boys, football is off the table. For girls, competitive gymnastics. There are likely other sports that could be found as way too high permanent risk.

For perspective on how I'm choosing: soccer is also risky and carries CTE risk, but less so than football. If boy wants to do skiing, running, or mountain biking, that is fine; crossfit, not so much (too aggressive). A certain amount of physical damage is far more acceptable than neurological damage. Things happen though; a friend of mine had his very young daughter fall into a pool and drown a few years after being preemie. That's this life on earth, sorrow and joy. I will give as much responsibility as I can, but the parent's responsibility to is to shape and limit around the ability of the child to react and foresee. Permitting choosing sports which have lifelong damage likelihood, when they are too young to understand the consequences, seems to be poor choice on my part.
On the cumulative salary of $1.8m over three years he's looking at an effective rate of around 35%. But he definitely won't lose half of his pension to taxes. That's one of the main advantages is that is spread out over a number of years. The NFL, with all its faults in neglecting players health, was wise to set players up with pensions.
Note that not all vulnerabilities are/can be patched by LineageOS, regardless of what the security patch level claims. Your device maintainer needs to actively merge patches into the kernel/device (see [0], note that this list relies on maintainers to update it). In addition, binary blob firmware needs to be patched by the manufacturer (e.g. Broadcom wi-fi exploits), which won't happen for devices that are out of support.

[0] https://cve.lineageos.org/kernels
It boggles my mind that this can happen.

I'm as pro-capitalist, pro-democracy, pro-make-a-fuck-ton-of-money as you can get... But even I am blown away by the wealth of some of the top billionaires.

Just think about the good that some of that could do for the country. Put it into science. Put it into social welfare systems. I don't care, put it into something!

I don't know what the solution is. The naive comment would be if you make above X billion everything else goes to some re-distribution fund... Obviously that will turn a lot of people off. But the point is, I just don't think anybody needs that kind of wealth.
Short answer - yes you can. Though, it's a serious hassle since you need to have someone running the company from A to Z for you. You can only be a passive owner/investor. That's it.
If you're getting paid it means what you're doing means something to someone, even if it doesn't mean anything to you.
this doesn't really mean anything? you would find similarly high iq people around anyone with the power and the money to acquire them.