PRO SA | Чат

PRO стандарты интернета или Почему вилка не лезет в розетку, а сайт открывается везде Обычная ситуация: прилетел в другую страну, достал зарядку, а вилка не лезет в розетку. Никто не виноват: когда-то просто не договорились, как эта вилка выглядит. Типов розеток в мире 15, и переходник ты покупаешь в аэропорту. А вот с интернетом договорились. Любой сайт открывается в любом браузере, хоть в Токио, хоть в Твери, потому что правила записали заранее. Эти записанные правила и называются RFC. Три вещи, которые экономят аналитику время: 1⃣ Статус написан в шапке. Не каждый RFC это стандарт. Internet Standard проверен годами и работающими реализациями, а Experimental и Informational ни к чему не обязывают, хотя выглядят точно так же. 2⃣ Документ не меняют. Нашли ошибку, выпускают новый номер, а в шапке старого появляется Obsoleted by. Поисковик легко отдаст отменённый: спецификация HTTP так переезжала дважды, из 2616 в 7230-7235, оттуда в 9110-9112. 3⃣ MUST, SHOULD, MAY. Готовая шкала обязательности: обязан, желательно, можно. Работает только запись заглавными, строчное must это обычный текст. Чего не было в ролике: как сослаться на RFC в требовании Формулировка, которая заканчивает спор на груминге: «Сервис ДОЛЖЕН возвращать ошибки в формате RFC 9457 (Problem Details for HTTP APIs). Поля type и title обязательны, коды ошибок домена передаются в расширенных полях.» Три правила такой ссылки: ➖ Номер, название и раздел: RFC 9110, §15.5.1, а не «по стандарту HTTP». Иначе разработчик и тестировщик прочитают её по-разному. ➖ Перед вставкой открой шапку и убедись, что документа не касается Obsoleted by. Ссылка на отменённый документ хуже, чем отсутствие ссылки: она выглядит обоснованной. ➖ Занеси решение в глоссарий проекта. Тогда второй раз этот спор не начнётся. Шпаргалка: что искать по номеру ✔️ HTTP: 9110 (семантика, коды, заголовки), 9112 (HTTP/1.1) ✔️ JSON: 8259, точечные правки JSON Patch: 6902 ✔️ Ссылки: 3986, дата и время: 3339 ✔️ Авторизация: 6749 (OAuth 2.0), токены: 7519 (JWT) ✔️ Ошибки API: 9457, email-адрес: 5322, UUID: 9562 Где смотреть: rfc-editor.org (статус, Obsoleted by, errata) и datatracker.ietf.org (история правок и черновики). А на какой стандарт чаще всего ссылаешься ты или все на экспертном мнении? ---- ✌️ ПРО СА| 🆕 НСА 2.0