LINUX.ORG.RU
ФорумTalks

Как в нормативной доке обозвать фичу?

 , , , ,


0

1

Допустим в рамках проекта по разработке реализации smtp сервера, была добавлена фича поддержки STARTTLS. Как бы глубокоуважаемый анон сослался бы на эту фичу в нормативной документации для РФ?

  • функциональность: 1
  • функция 1
  • реализация поддержки|поддержка <feature name> 3

  • поддержка в общем случае автоматически привносит двусмысленность, т.к. подразумевает поддержку, уровень которой может оказаться нигде не регламентирован

Линукс тут при том, что больно уж часто принимает участие в подобных доках.



Последнее исправление: faq2 (всего исправлений: 9)

Такого рода документация пишется не для того, чтобы её читали, а щоб було. Это такой Зелёный слоник от документации. Советую оторваться по полной.

Не «функционалтность», а «функциональная возможность». Учи канцелярский язык, косплей мракобеса.

WitcherGeralt ★★
()

была добавлена фича поддержки STARTTLS.

Была добавлена поддержка протокола/команды/whatever STARTTLS

Как бы глубокоуважаемый анон сослался бы на эту фичу нормативной документации для РФ?

Анон бы матом сказал, но можно «возможность», «функция». Непонятно только, зачем.

t184256 ★★★★★
()

добавлена ПЛЮШКА поддержки STARTTLS

И придумывать какой-то перевод как «тэйк» перевели «браток»

Bad_ptr ★★★★★
()

но на самом деле ФИЧА уже звучит хорошо
так что надо всячески продвигать в официальную документацию

внедрили же туда дорожные карты и транспарентности

Bad_ptr ★★★★★
()

НАБРАСЫВАТЬ

https://translate.google.ru/?sl=en&tl=ru&text=feature&op=translate

Имя существительное

особенность
feature, peculiarity, singularity, characteristic, particularity, trait

черта
feature, line, dash, stroke, trace, side

характеристика
characteristic, feature, characterization, performance, specification, curve

свойство
property, characteristic, feature, attribute, affinity, quality

признак
sign, feature, attribute, tag, symptom, flag

характерная черта
characteristic, feature, trait, peculiarity, attribute, quality

деталь
detail, part, piece, component, member, feature

полнометражный фильм
feature, full-length film

черта характера
feature, strain, idiosyncrasy

сенсационный материал
feature

местный предмет
feature

аттракцион
attraction, feature

черта лица
feature

подробность рельефа местности
feature

гвоздь программы
clou, drawing card, feature

большая газетная статья
feature

большая статья в газете
feature

боевик
thriller, hitman, sock, feature, smash-hit

основной фильм кинопрограммы
feature

Глагол

показывать
show, indicate, display, reveal, exhibit, feature

напоминать чертами лица
feature

изображать
depict, portray, represent, paint, describe, feature

выступать в главной роли
feature

быть характерной чертой
feature

показать на экране
feature

выводить в главной роли
feature

набрасывать
throw, draw, draft, chalk out, throw on, feature

рисовать
draw, depict, design, pencil, depicture, feature

зарисовать
feature

обрисовывать
outline, depict, delineate, picture, feature, depicture

исполнять главную роль
feature

отводить важнейшее место
feature

делать гвоздем программы
feature

походить
feature, border

Bad_ptr ★★★★★
()

ну или
в программу был вбит новый гвоздь с поддержкой STARTTLS

Bad_ptr ★★★★★
()
Ответ на: комментарий от WitcherGeralt

А есть где словари для начинающих?

faq2
() автор топика
Ответ на: комментарий от t184256

Тут вопрос подхода, можно делать низачем. Но почитай доки от IETF. Там канцелярщина во все поля, она чем лучше? Тем что на ангельском? Ну ребзя формально +/- договариваются чтобы не возникала неоднозначность на пустом месте.

faq2
() автор топика
Ответ на: комментарий от Bad_ptr

Дорожная карта и вехи слишком хорошая метафора и не англицизм, чтобы их не внедрять. Транспарентность - пока не встречал, в основном всё же упоминается прозрачность.

faq2
() автор топика
Ответ на: комментарий от Bad_ptr

Так вот где корни основных лоровских упражнений!

faq2
() автор топика

В рамках проекта по разработке smtp сервера, была реализована поддержка защищённого соединения

system-root ★★★★★
()
Ответ на: комментарий от alysnix

Режим - слишком узкое понятие для функционала в общем случае.

faq2
() автор топика
Ответ на: комментарий от system-root

короче срок

как-будто что-то плохое.

faq2
() автор топика
Ответ на: комментарий от system-root

В смысле в твоём варике больше буков, а не в смысле больше буков должно быть, буков должно быть минимум, доки то казённые, а глазки - нетЪ.

faq2
() автор топика
Ответ на: комментарий от faq2

Если нужно конкретнее, ты скажи куда ты это пишешь. Это изменение в ЭД? Проще выпустить замену листов к РД и всё.

system-root ★★★★★
()
Ответ на: комментарий от t184256

@Zhbert можешь перенести в general или ещё куда-то где анон может матом сказать? Чет я не подумавши сюда закинул.

faq2
() автор топика
Ответ на: комментарий от faq2

Ты имеешь ввиду протокол совещания, где были решения? Если это просто memo для руководства - можно писать как угодно. Если совещания где будет подпись участников - пиши как было.

system-root ★★★★★
()
Ответ на: комментарий от system-root

Совершенно верно - с подписью. Основная идея отточить локальный язык стандартов и постановок, т.к. как бы убого это не выглядело, на самом деле, нормальные штуки типа RFC написаны не менее канцелярским языком если задуматься, но это скорее помогает, чем мешает после определённой начитки.

Я понимаю, что в идеале надо просто читать много стандартов и системных постановок на русском. Но хотелось бы какой-то переводчик что-ли найти на первое время.

faq2
() автор топика
Ответ на: комментарий от faq2

Нужен не переводчик, а фреймворк. С самого начала следует идти от минимальных определений которые даны в ГОСТ и расширять уже своей терминологией в едином формате. Например, если вы решили, что API - это «прикладной программный интерфейс» то везде дальше используйте эту терминологию. Если вы решили, что разрабатываемое ПО разбитое на микросервисы «на самом деле» разбито на «подсистемы», то уже пишите в рамках этой концепции.

Так и с фичами. «реализация поддержки» - это приговор. Это означает, что поддержка обязана быть. По этому такое следует писать только если оно есть, иначе обтекать.

system-root ★★★★★
()
Ответ на: комментарий от system-root

А есть какой-то корневой +/- документ с глоссарием? Про поддержку - интересно, понял, хотя в данном конкретном случае порядок оказания услуг по поддержке зафиксирован в основном соглашении например, т.е. весь набор функциональности подразумевает поддержку.

faq2
() автор топика
Ответ на: комментарий от faq2

А есть какой-то корневой +/- документ с глоссарием?

Да, иначе будет ерунда. Например из недавнего:

Реализация функциональности КИАПУПД и мер защиты (ИАФ.1, ИАФ.3, ИАФ.4, ИАФ.5, УПД.1, УПД.2, УПД.4, УПД.5, УПД.6, УПД.10, УПД.11, УПД.16) обеспечивается системным и прикладным ПО входящим в состав АС

Мой комментарий к документу:

есть общее и специальное ПО. Другого нет.

Автор в тексте имел ввиду «общее» ПО, но если оставить как есть, то и «специальное» можно подвести под требования ФСТЭК потому, что хз что такое «прикладное». Наверное это то, что вы написали ребята? И потом с горящей жопой иметь беседы со следователем.

Слова имеют значение.

system-root ★★★★★
()
Ответ на: комментарий от system-root

Отсыпь монокль…

Но, так-то лучше дай напочитать доков, желательно про системное(можно же так вещать?) ПО.

faq2
() автор топика
Ответ на: комментарий от faq2

Есть стандартный набор с ГОСТ 2, 19, детскими (дедовскими) 24, 34, если говорить о частном случае разработки. Есть расширенные, вроде РВ 0019. При этом есть ведь и Р 56939-2016 с Р ИСО 10007-2019 и так далее в кроличью нору, плюс по сути всё, что существует в ITIL. Всё зависит от потребностей. Если ничего из этого не используется на предприятии, а писать хочется так, будто «мы крутые», то лучше и не стоит, наверное. Канцелярит появился не потому, что захотелось, а как часть способа выражать мысли менее многозначно.

system-root ★★★★★
()
Ответ на: комментарий от system-root

выражать мысли менее многозначно

this—^

Спасибо, будем пробовать почитать. Это где-то централизованно можно глянуть или просто гуглитьспутничать первое попавшееся?

faq2
() автор топика
Ответ на: комментарий от faq2

Если ты хочешь знать «всё», то посмотри что должен знать тех. писатель, нормоконтролёр, системный аналитик. Эм, а потом подумай зачем ты это делаешь, если собрался работать за троих.

system-root ★★★★★
()
Ответ на: комментарий от system-root

посмотри что должен знать

Это само по-себе довольно-таки сложное действо.

Насчёт зачем - сам задаюсь таким вопросом…

faq2
() автор топика

в рамках проекта по разработке реализации smtp сервера

Вы там сервер или реализацию разрабатываете?

ashot ★★★★
()
Ответ на: комментарий от ashot

Итак, подытожим вышеозвученное:

В рамках реализации разработки smtp сервера, была одобрена дорожная карта внедрения фукциональной возможости STARTTLS, для обеспечения транспорентности, обусловленной необходимостью внедрения прикладной фичи.

ashot ★★★★
()

В вечернюю школу запишись и пройди заново курс русского языка, раз ты настолько деградировал, что не можешь в родном языке ориентироваться.

nemixer
()
Ответ на: комментарий от ashot

Резонный вопрос, хотя пример я конечно с потолка взял.

faq2
() автор топика
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.