Как понять, какую версию документа вы читаете
Различайте дату страницы, выпуск документа и статус редакции, чтобы ссылаться на подходящий текст.
При поиске инструкции легко найти сразу несколько ответов от одного автора. На одной странице написано «проект», в другой опубликован тот же заголовок с новой датой, а третья ведёт на предыдущий выпуск. Чтобы понять, какой текст использовать, сначала выясните цель проверки. Для действующей инструкции важна подходящая опубликованная редакция. Для разбора старого решения нужен текст, доступный на момент этого решения.
Представим, что в заметке команды упомянута рекомендация по доступности веб-страницы. Ссылка ведёт на страницу WCAG 2.2, но рядом нет даты. Коллега открыл документ несколько месяцев спустя и увидел ссылки на опубликованную версию, проект редакторов и историю. Нужно зафиксировать точную редакцию и понять, изменился ли смысл нужного пункта.
Найдите сведения о документе
Откройте шапку страницы. Ищите название, издателя, статус и дату выпуска. На странице WCAG W3C указывает дату рекомендации и отдельно приводит ссылки на конкретную версию, последнюю опубликованную версию и рабочий проект. Эти адреса служат разным целям, поэтому полезно сохранить именно тот, который соответствует вашему вопросу.
Отличайте дату публикации от даты, которую поисковик показывает рядом с результатом. Поисковая дата может относиться к обновлению страницы или обнаружению текста. Она помогает сориентироваться в выдаче. Для цитирования берите дату и статус, указанные владельцем самого документа.
Проверьте, не открыли ли вы перевод или пояснение. В этих материалах может быть собственная дата, отличная от даты оригинала. Если перевод помогает читать, используйте его вместе со ссылкой на соответствующую исходную редакцию. Сопоставьте заголовки разделов, чтобы убедиться, что речь идёт об одном месте.
Выберите ссылку для вашей задачи
Если вы делаете список источников к уже выполненной проверке, найдите датированный выпуск. При следующем открытии этой ссылки читатель должен увидеть тот же документ, на который опиралась команда. Добавьте точный раздел, чтобы его не пришлось искать по длинной странице. Запишите название издателя и номер версии в обычном тексте на случай, если адрес изменится.
Если ведёте инструкцию для будущей работы, используйте ссылку на подходящую актуальную редакцию и добавьте дату, когда её проверили. Иногда важно сохранить две ссылки. Одна ведёт на источник, который читали сегодня. Вторая позволяет свериться с обновлениями. Подпишите, зачем нужна каждая.
Если вас интересует предстоящая редакция, откройте проект. Запишите его статус и дату. Изменение в проекте можно учитывать при планировании. Для утверждения о действующей формулировке сначала проверьте, что публикация приобрела нужный статус. Само наличие текста на сайте организации ещё не означает завершения редакционного процесса.
Сравните один пункт вместо целых документов
Запишите раздел или термин, от которого зависит решение. Откройте его в обеих редакциях и проверьте формулировку, исключения, определения и связанные разделы. Перемещение пункта не обязательно меняет его смысл. Иногда неизменная фраза ссылается на новое определение, и тогда различие находится по соседней ссылке.
Проверьте историю и опубликованные исправления. Издатель может описать, что поменялось и почему. В научных публикациях иногда отдельно размещают исправление или уведомление об отзыве. Сопоставляйте его с конкретной работой и используемой версией. Статус, указанный в самой заметке, обычно полезнее догадки по дате файла.
Зафиксируйте только то, что вы проверили. Формулировка «в нужном пункте различий не нашёл» точнее утверждения, что оба документа полностью совпадают. Если изменился термин, процитируйте короткий необходимый фрагмент или перескажите различие своими словами. Укажите, влияет ли оно на решение команды.
Оформите короткую запись о версии
В заметку можно поместить название документа, редакцию, статус, ссылку и дату проверки. Для рабочего примера хватит указания «WCAG 2.2, опубликованная рекомендация, раздел о минимальном контрасте». Рядом сохраните датированный URL. Если вы сравнивали рабочий проект, добавьте отдельную строку с его статусом и объясните, зачем его открывали.
Попросите коллегу перейти по ссылке без дополнительных подсказок. Проверка удалась, если он находит тот же текст и может увидеть, по каким признакам определена редакция. Если ссылка открывает только начало сайта или перенаправляет на страницу поиска, добавьте название раздела и постоянный идентификатор, который выдаёт издатель.
В конце решите, когда запись стоит проверять снова. Можно привязать проверку к новому выпуску инструкции или моменту, когда команда будет принимать работу. Тогда обновление источника становится частью конкретного действия. Для исторической записи дата обычно остаётся прежней. В ней вы фиксируете основание прошлого решения, а не автоматически заменяете его последним доступным текстом.
Пример работы с двумя ссылками
Допустим, в прошлогоднем отчёте стоит общий адрес спецификации и название пункта. Вы открываете историю публикаций и находите выпуск, который действовал на дату отчёта. Затем проверяете, совпадает ли нужный фрагмент с записью команды. Если определить выпуск по отчёту нельзя, отметьте, что точную ссылку восстановить не удалось.
Для новой инструкции запишите, какой выпуск использовали при составлении и когда хотите проверить обновления. Исторический отчёт оставьте с прежним основанием и добавьте комментарий о возможном расхождении. Это пригодится, если коллега сравнит два документа и увидит в них одинаковое название при разных ссылках.
Источники
- W3C. Типы публикуемых документов — описание статусов и назначения различных видов документов.
- W3C. Датированная редакция WCAG 2.2 от 12 декабря 2024 года — пример постоянной ссылки на конкретную версию.
- Crossref. Crossmark — сведения о проверке обновлений у участвующих издателей.