Основные положения системы разработки и постановки на производство промышленной продукции, определено место техдокументации (ТД) в жизненном цикле продукции, изложены базовые аспекты техрегулирования в сфере разработки и оборота ТД, приведен пример системы управления качеством техдокументации промышленного предприятия, рассмотрены проблемы экспертизы качества и сертификации ТД. Редакция от 29.04.2021.

Пришло время освежить эту статью, включая ее название. Библиотеки взаимоувязанных документов для AuthorIT безусловно полезны тем, кто пользуется программой AuthorIT для разработки технической документации. Но таких счастливцев, к сожалению, найдется немного, а счастливчиков - владельцев AuthorIT Workgroup Edition - и того меньше. Поэтому речь пойдет о замене инструмента, редкого и относительно дорогого AuthorIT, на широко распространенный и практически бесплатный Atlassian Confluence путем воспроизведения последним функциональных возможностей первого.

Кому все это надо? В явном виде тем, кто непосредственно занимается писаниной, в неявном - ВООБЩЕ ВСЕМ участникам проекта, даже заказчику. Ведь ни для кого не секрет, что без громадного количества бумаги не обходится ни один даже самый простенький проект. Редакция от 13.11.2021.

Связывание задач Jira со страницами Atlassian Confluence не несет в себе ничего принципиально нового. Кроме того, что ранее в Jira импортировали 95 задач, а в Atlassian Confluence - ровно столько же разделов, подразделов, пунктов и подпунктов документа в виде отдельных страниц, каждая из которых взаимно-однозначно соответствует одной-единственной задаче.

В поле Description каждой задачи имеется ссылка, позволяющая мгновенно разыскать «еёйную» страницу, чтобы затем связать задачу и страницу, как показано на рисунке ниже. Редакция от 17.11.2021.

Создание задач Jira с помощью внешних ссылок - занятие полезное. Ведь одно дело - жать на кнопки довольно тормознутого интерфейса самой Jira, а совсем другое дело - единожды щелкнуть по ссылке из какой-нибудь тематической базы знаний, к примеру, создать задачу 1.1.2 Сбор исходных материалов непосредственно из ГОСТ 19.102-77. И потом, когда какой-нибудь охламон из особо «эффективных» или военпред из генеральских сыночков поинтересуется, откуда в плане проекта взялась такая задача и почему она бешено сжирает ресурсы, можно будет ткнуть в обратную ссылку и показать, что это требование конкретного стандарта. Таким образом, создание задач Jira внешними ссылками из авторитетных источников полностью и целиком обосновывает все действия «создателя» и исключает возможность предъявить какие-либо претензии ко всей его деятельности. Редакция от 04.04.2021.

Юникоды (unicode) в гиперссылках (hyperlink) - это дело серьезное. Если не полениться и открыть страничку Общие положения [из разд. 1 ГОСТ 19.201-78], можно легко в этом убедиться. Часть гиперссылок на ней выполнена текстом (Гантт), подавляющая - картинками (), а кое-что - юникодами (🆕 ✅ 🔗). И все вроде ничего, но:

• если в каждой гиперссылке будет содержаться слово Гантт (а еще Открыть, Создать и тому подобное), то текст страницы будет настолько заспамлен этими словечками, что поисковики «за деревьями не увидят леса» - основной тематики страницы. И снизят ее рейтинг в поиске. Поэтому иконки и пиктограммы - и только они;
• при этом создание множества различных гиперссылок с одинаковыми картинками - занятие муторное и дезориентирующее - сходу и не разобраться, какой ссылкой какая иконка «обернута», а по сему -
• только символы юникода!

Это дешево, надежно и практично, а делается легко и просто, см. ниже. Редакция от 04.04.2021.