Appearance
Правила раздела «Нормативная документация»
1) Единственный источник нормативов
Все нормативы, используемые в проекте (обучение/кейсы/шаблоны), берём только из папки:
/docs/Нормативная документация/
Внешние источники (интернет-ссылки, чужие базы, пересказы) не используем.
Исключение: разрешено проверять актуальность документа в интернете только по ссылке на официальный сайт, указанной в таблице:
/docs/Нормативная документация/актуальность-документов.md
2) Структура хранения
/docs/Нормативная документация/ГОСТы/— ГОСТы/docs/Нормативная документация/СП/— СП (Своды правил)
Каждый документ кладём в свою папку и рядом делаем карточку в .md.
3) Что можно добавлять
- PDF/сканы/фото страниц (как первоисточник)
- .md карточки (выдержки/конспект/таблицы допусков)
4) Формат карточки документа (.md)
Рекомендуемый шаблон:
- Полное название / номер / год
- Статус и дата введения (если есть в документе)
- Область применения
- Ключевые требования и допуски (с указанием пунктов)
- Методы контроля/измерения
- Маркировка/приёмка/хранение (если применимо)
5) Цитирование
- При переносе текста в .md:
- обязательно указывать номер пункта/таблицы
- не смешивать нормы из разных документов
6) Связь с кейсами
Если в кейсе указывается норма — ссылка/пункт должны вести на документ, который лежит внутри этого раздела.