5 ms·
How to read an RFC
- _verandaguy 8y agoTo address the elephant in the room: this is a repost, but it's really useful for newer programmers looking to familiarize themselves with the (still ubiquitous) RFC format, and there are always new programmers browsing HN.
- Tomte 8y agoYou‘re imagining the elephant. There is no elephant. Reposts are totally okay, explicitly said in https://news.ycombinator.com/newsfaq.html https://news.ycombinator.com/newsfaq.html We need more reposts of cool submissions that were overlooked, not fewer! The mods have even implemented two systems to „rescue“ submissions: invitations to repost with a bonus and auto-repost. And I‘m also working on that, most of my submissions are reposts. :-)
- jwilk 8y ago> this is a repost Is it? The post is from yesterday if the URL is to be believed. I don't see any older submission than this one: https://news.ycombinator.com/from?site=mnot.net https://news.ycombinator.com/from?site=mnot.net
- Sir_Cmpwn 8y agoArchive: http://archive.fo/KHier http://archive.fo/KHier Personally I think the most important thing about reading RFCs is to do it in the first place. Note that Arch Linux users can install the 'rfc' package to get them in /usr/share/doc/rfc/txt/.
- dredmorbius 8y agoDebian (and derived distros) also has several RFC packages. Principally: doc-rfc, doc-rfc-experimental, doc-rfc-fyi-bcp, doc-rfc-informational, doc-rfc-misc, doc-rfc-old-std, doc-rfc-others, doc-rfc-std, and doc-rfc-std-proposed. https://packages.debian.org/search?keywords=rfc https://packages.debian.org/search?keywords=rfc
- jwilk 8y agoBetter link: https://packages.debian.org/source/sid/doc-rfc https://packages.debian.org/source/sid/doc-rfc
- dredmorbius 8y agoThanks. The full set can be large and isn't necessarily useful. Pulling subsets may be preferable.
- eat_veggies 8y agoThe favicon is a green lock: https://www.google.com/s2/favicons?domain=www.mnot.net https://www.google.com/s2/favicons?domain=www.mnot.net that's diabolical haha
- Tomte 8y agoMaybe Google should use their image recognition tech to detect and punish this. I‘m only half-joking, browser developers tend to take a very dim view of such misleading techniques.
- CodesInChaos 8y agoOne of the reasons why I prefer insecurity indicators over security indicators is that the user doesn't have to know which parts of the UI are trusted to distinguish secure from insecure sites. (Another important reason is that an encrypted site is not necessarily secure, so the security indicator can be taken as more of an endorsement of the site than intended)
- jessaustin 8y agoIt would have been more clever with a transparent background.
- combatentropy 8y agoWriting is hard. Writing clearly is harder. Writing clearly in a way that won't run the reader out of the room is harder still. So my hat is off to anyone writing an RFC. Now there were a couple of fertile points in the article that could bear more development in another piece. 1. An RFC sometimes focuses on the sender, without then turning to the receiver. For example, suppose it says that the Foo header must not contain Bar. So if a sender sends a header of "Foo: Bar" then it is clearly "nonconformant." But what is the recipient to do? Ignore it, send a certain error message, what? This is especially pertinent given that the Robustness Principle advises that you "Be conservative in what you do, be liberal in what you accept from others" (https://en.wikipedia.org/wiki/Robustness_principle https://en.wikipedia.org/wiki/Robustness_principle). The takeaway is, I think that the IETF should work it explicitly and prominently into the RFC template. In the editor's guide or whatever for how to write an RFC, it should call out this very problem and say something like, "For every rule you lay down, be sure to address how the recipient should handle it when the sender breaks the rule." 2. RFCs should remember that readers are humans. For example, "In the example above, whitespace isn’t allowed around the semicolon, but you can bet that some people will put it there." Right. Some people will put it there because for 20 years in everyday writing they have seen semicolons followed by whitespace. It is part of being a writer to not just put your claim in "grammatical English" but also to take into consideration the reader's culture and background. You can't say, "Well, there clearly is no whitespace in the Backus–Naur form that I painstakingly laid out for you." Humans are not computers. They are not functions. They do not always return the same output for a certain input. This is because they are always entertaining several streams of input, most of which you don't have control over.
- deleted 8y ago[deleted]
- n_t 8y agoHere is a site which does pretty print of RFCs - https://pretty-rfc.herokuapp.com https://pretty-rfc.herokuapp.com Also, while reading RFCs, following is handy - MUST (absolutely required) MUST NOT (absolutely prohibited) SHOULD (highly recommended) SHOULD NOT (highly not recommended) MAY (meh)
- RX14 8y agoI much prefer the https://tools.ietf.org/html/rfc3986 https://tools.ietf.org/html/rfc3986 interface, I think it's pretty much perfect.
- exceptione 8y agoIt isn't for printing though. The parent site looks way better in print preview.
- liveoneggs 8y agothe DHCP RFCs are some of my favorites (2131 and 2132) for clarity and ease of reading
- amp108 8y agoI already know the difference between "MUST", "MUST NOT", "MAY", "SHOULD", "SHOULD NOT", "Obsoletes", et al, but I still feel like there's an RFC code that I haven't cracked.
- mettamage 8y agoInspired by this topic I asked the question on how to read documentation [1] (I searched for it, it didn't seem to be there). I really could improve my documentation reading skills but don't know where to effectively search for it (I normally search on HN for quality content on technical topics). [1] Ask HN: How to read documentation? -- https://news.ycombinator.com/item?id=17670431 https://news.ycombinator.com/item?id=17670431