Похожие чаты

Кстати говоря.... техпис писатель, техпис не проверятель. Как вы проверяете свою

же документацию? На что именно проверки и как вы их делаете?

7 ответов

9 просмотров

на здравый смысл, орфографию и применимость в жизни) а на соответствие реализации это пускай тестирование проверяет)

Марина- Автор вопроса
Aleksandr Simonov
на здравый смысл, орфографию и применимость в жизн...

А где сквозные проверки? Чтоб единообразие было? А где сверки частей одного документа с частями других документов?

Марина
А где сквозные проверки? Чтоб единообразие было? А...

Тут уже должна включиться служба качества: нормоконтроль и прочие. Которые ведь тоже предусмотрены ещё с незапамятных времен

Марина- Автор вопроса
Vasilisa N
Тут уже должна включиться служба качества: нормоко...

Не во всех конторах есть отдельные нормоконтролеры. Если отдельных нет, то и проверять не надо?

Марина
Не во всех конторах есть отдельные нормоконтролеры...

Может не быть отдельного человека - нормоконтролера, может не быть системы менеджмента качества, но их функции никуда не денутся, значит их осуществляет кто-то другой?... В общем и целом: единые стандарты к написанию - будет и единообразие. Требования к документированию самого процесса написания документации (тут уже можно застрелиться, но этого часто не хватает). Другой что-то пишет, ты что-то пишешь, потом выясняется, что Вася и Петя писали +/- про одно и то же... И все написали разное)) Что про нк, что про систему качества документированной информации много всего написано

Марина- Автор вопроса
Марина
А где сквозные проверки? Чтоб единообразие было? А...

Согласна, проверок куча, столько же, сколько критериев документации как минимум. 1. Полнота, точность, актуальность (все необходимые сведения для выполнения действия); 2. Понятность и соответствие ЦА; 3. Соответствие глоссарию и стайлгайду; 4. Структурированность, последовательность, логичность; 5. Удобство использования (можно быстро найти всю нужную инфу); 6. Консистентность (единообразие во всём). И т.д.

Похожие вопросы

Обсуждают сегодня

как правильно удалить сддм? прописал в etc/portage.use/plasma-meta -sddm , но при обновлении юзов мне предлагает поставить lightdm (ещё лучше 😡), добавил туда - display-manage...
REDis
25
#include <stdio.h> #include <stdlib.h> #include <time.h> void mass_first_generate(int mass[5][7]) {     for (int N = 0; N < 5; N++) {         for (int A = 0; A < 7; A++) {   ...
Чувак
6
Всем привет! Имеется функция: function IsValidChar(ch: UTF8Char): Boolean; var i: Integer; ValidChars: AnsiString; begin ValidChars := 'abcdefghijklmnopqrstuvwxyzABCDE...
Евгений
44
https://www.linkedin.com/posts/ugama-benedicta-kelechi-codergirl-103041300_mobiledevelopment-fluttertraining-handsonlearning-activity-7263445699227254784-IdHB?utm_source=share...
CoderGirl
16
like, question: int b = 99999; is this valid and predictable C?
Ludovic 'Archivist' Lagouardette
15
Помогите пожалуйста. Делаю систему плагинов. Проблема сейчас в такая: плагины загружаются в основном потоке. FLibHandle := SafeLoadLibrary(FFileName) Но нужно еще выполнить фу...
Илья 🤣
10
VIP-397 BNBx Oracle implementation upgrade Summary This proposal, if approved, will upgrade the implementation of the BNBx Oracle contract on Venus from version 1 (V1) to v...
Venus Announcements
2
Ну вот просто даже давайте вот как. Какой нибудь конкретный кейс, можете в пример привести, где бч работает и приносит прикладную пользу, а не просто что бы было? Не крипту.
Alexander Andreev
22
For all those that keep asking why no pump? why this ? and why that...? Please close ur ewt chart and open 2 others - TOTAL (total mc) and BTC.D (btc dominance). Maybe BTC a...
Inn3r_G
19
"Since pnut can flip FTM easily, I'm swapping my FTM to pnut and hoping for a easy x5-x10" Perfect recipe for disaster. NFA but chances are, you'll end up as exit liquidity ...
C. A.
7
Карта сайта