News for hackers. Stuff that matters.
Re:Microsoft REST API Guidelines by arkadiytehgraet on Friday November 22, 2019 @04:37PM (#21610355)
Every single person writing a comment on Hacker News should have to memorize this rule:

Never use code formatting for text, as it makes it unreadable on the mobile devices.

For my own (and others') convenience, here is unformatted rule table from parent comment:

GET - Return the current value of an object, is idempotent;

PUT - Replace an object, or create a named object, when applicable, is idempotent;

DELETE - Delete an object, is idempotent;

POST - Create a new object based on the data provided, or submit a command, NOT idempotent;

HEAD - Return metadata of an object for a GET response. Resources that support the GET method MAY support the HEAD method as well, is idempotent;

PATCH - Apply a partial update to an object, NOT idempotent;

OPTIONS - Get information about a request, is idempotent.

Re:Microsoft REST API Guidelines by kevin_thibedeau on Friday November 22, 2019 @04:50PM (#21610487)
> Never use code formatting for text

Until such time that the site supports quoted text a little civil disobedience is warranted. It's not like it's a hard problem.

Re:Microsoft REST API Guidelines by Stratoscope on Friday November 22, 2019 @07:01PM (#21611387)
Using code formatting for quoted text is not civil disobedience, it is an innocent mistake that should be gently pointed out and corrected.

Continuing to use code formatting after being made aware of the problem wouldn't be civil disobedience either. It would merely inconvenience the large number of people who read HN on mobile devices, for no purpose.

(Edited to remove a somewhat unrelated philosophical note.)

Re:Microsoft REST API Guidelines by monospaceisgood on Friday November 22, 2019 @08:13PM (#21611738)
> Continuing to use code formatting after being made aware of the problem wouldn't be civil disobedience either. It would merely inconvenience the large number of people who read HN on mobile devices, for no purpose.

We all do it from time to time, even you did it few days ago [1], monospace have its purpose, maybe HN should simply fix it.

[1] https://news.ycombinator.com/item?id=21436522

Re:Microsoft REST API Guidelines by Stratoscope on Friday November 22, 2019 @08:41PM (#21611853)
Oh come now. I used code formatting quite deliberately in that comment. I wanted to preserve the centering and single-spacing of the text on the back of the radio as best I could. The lines are short and render fine on a mobile device.

So yes, given HN's meager formatting options, monospaceisgood for that! :-)

You may note that later in that same comment there is a longer quote that I formatted in non-code italics.

But hey, if I encouraged you to create an HN account, that's great! Speaking as someone who writes code in a proportional font, we may have some interesting discussions ahead of us. ;-)

Re:Microsoft REST API Guidelines by kevin_thibedeau on Friday November 22, 2019 @09:42PM (#21612076)
It is a sign of an unmet need. Why do we even have code formatting? If minimalism is the goal then remove that overwrought feature too.
Re:Microsoft REST API Guidelines by dragonwriter on Saturday November 23, 2019 @12:03AM (#21612576)
> Why do we even have code formatting?

Because once upon a time the “H” in “HN” meant something.

Re:Microsoft REST API Guidelines by PowerfulWizard on Friday November 22, 2019 @06:36PM (#21611229)
> Until such time that the site supports quoted text a little civil disobedience is warranted. It's not like it's a hard problem.

Italics works fine for quote IMO.

Re:Microsoft REST API Guidelines by nvrspyx on Friday November 22, 2019 @06:57PM (#21611367)
____

Italics works fine for quote IMO

____

I propose using four underscores as a delimiter of a quote block, like asciidoctor, in addition to italics. I think it looks better than the markdown way of using ">" in front of a quote as it can get quite cumbersome and ugly when you're quoting multiple lines of something. However, I generally enjoy using markdown more if it works on a website. It just looks ugly IMO if it doesn't.

Re:Microsoft REST API Guidelines by Jaruzel on Saturday November 23, 2019 @03:48AM (#21613149)
the markdown way of using ">"

I think you'll find the practice of prefixing quoted lines with ">" originated with old Unix email and Usenet.

Re:Microsoft REST API Guidelines by nvrspyx on Saturday November 23, 2019 @11:22AM (#21614837)
I’m rather young (on the border of Gen Y and Gen Z) so I guess I’m not old enough to have used either old Unix email or Usenet, so thank you for that tidbit.
Re:Microsoft REST API Guidelines by Jaruzel on Sunday November 24, 2019 @11:58AM (#21621621)
No problem. Wasn't mean to be sarcastic, but reading back it may come across that way.
Re:Microsoft REST API Guidelines by nvrspyx on Monday November 25, 2019 @06:22PM (#21633983)
It didn’t come across like that at all. I found it very educational actually as I imagine that’s where Gruber/Swartz got the syntax from.
Re:Microsoft REST API Guidelines by Stratoscope on Friday November 22, 2019 @07:10PM (#21611437)
Another rule to memorize: if one of the reasons for using code formatting is to preserve line breaks, simply add an extra blank line between paragraphs. Think of each line as its own paragraph. Then the text will be readable on any device.
Re:Microsoft REST API Guidelines by tasogare on Saturday November 23, 2019 @03:48AM (#21613150)
That’s still super annoying. An annoyance shared with markdown (which at least has the double space at end of line trick, which is super ugly).
Re:Microsoft REST API Guidelines by jedberg on Friday November 22, 2019 @04:49PM (#21610470)
As someone who mostly uses mobile, I agree with you, but in this case I couldn't figure out a way to make it readable without code formatting and without retyping it.

Thank you for the effort. I've updated my post with your text.