Статьи

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

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

Библиотеки взаимоувязанных документов представляют особый интерес при обратной разработке. И не только — библиотеки взаимоувязанных документов позволяют документировать с самых различных «точек входа», с любой стадии или этапа жизненного цикла.

Обратимся ко всеми любимой педевикии, поскольку стандарты всегда несколько отстают от образования некоторой сущности или «новой формулы». Итак, «Обратная разработка (обратный инжиниринг, реверс–инжиниринг; англ. reverse engineering) — исследование некоторого изделия или программы, а также документации на него с целью понять принцип его работы и, чаще всего, воспроизвести устройство, программу или иной объект с аналогичными функциями, но без копирования как такового.». И начнем воспроизводить. Редакция от 16.12.2024.

Быстрый доступ к технической терминологии, особенно в критических ситуациях — а риск их возникновения неминуем при согласовании с заказчиком технического задания, технического проекта, в ходе приемки–сдачи работ или просто во время сложных переговоров — бывает крайне важно очень быстро, но без судорожного перелистывания страниц множества ГОСТов, найти технический термин и соответствующее ему стандартизованное определение. Редакция от 08.12.2024.

Экспорт взаимоувязанных документов из Atlassian Confluence в Microsoft™ Word выполняется из текущего рабочего пространства выбором пункта из того же меню, что использовалось для импорта, только Export to Word, см. рисунок из подраздела Импорт документов из Microsoft™ Word в Atlassian Confluence. Но сначала следует внести изменение в любой из общих топиков, чтобы совсем уж было очевидно, что библиотека взаимоувязанных документов, сформированная в предыдущем подразделе, реально работает. Редакция от 09.12.2024.

Вокруг 34–го комплекса стандартов который год наблюдается странная возня. Впрочем, как и вокруг Росстандарта в целом — или как его там нонче принято величать? Стандарты комплекса отменяют без замены, оставляя разработчиков автоматизированных систем в некотором недоумении: как жить и творить дальше? Ведь ГОСТ 34.хуз, РД 50–34.698–90 и прочие документы комплекса, разработанные в самый пик целенаправленного развала Советского Союза, последствия которого аукаются всем нам на протяжении тридцати лет (и будут аукаться еще лет тридцать), все те же смутные тридцать лет служили разработчикам АС верой и правдой! ЗАЧЕМ?! Редакция от 17.12.2024.

Как вставлять гиперссылки при создании или редактировании веб-страниц (HTML–контента) сайтов в AuthorIT? В книге об AuthorIT гиперссылкам посвящен лишь один коротенький подраздел, разъясняющий минимальные необходимые и достаточные приемы создания и использования их при автоматизированной разработке технической документации — Организация гиперссылок в AuthorIT. Продолжаем раскрывать тему гиперссылок. Редакция от 09.12.2024.

В мае 2019 года принят ГОСТ Р 2.105–2019 Единая система конструкторской документации. Общие требования к текстовым документам. Unified system for design documentation. General requirements for textual documents. Дата введения в действие — 01.02.2020 г. Между тем ГОСТ 2.105–95 остается в статусе действующего. Разница между этими двумя стандартами состоит лишь в том, что ГОСТ Р 2.105 является национальным, а ГОСТ 2.105–95 — межгосударственным, сходство — в том, что оба они являются стандартами на процесс и на продукцию одновременно (следует помнить, что техническая документация является товарной продукцией). Cравнительный анализ данных документов показал все то «хорошее новое», что появилось в ГОСТ Р 2.105–2019. В качестве инструмента сравнения использовался онлайновый сервис tools.pdf24.org/ru/compare–pdf. Редакция от 13.12.2024.

О нелюбви IT–специалистов к государственным стандартам (ГОСТам) в области информационных технологий (IT). Почему IT–специалисты в большинстве своем так не любят ГОСТы в частности и стандарты вообще? И почему стоит их (ГОСТы) хотя бы ценить? Редакция от 13.12.2024.

Поисковые машины по запросам «единство терминологии» или «терминологическое единство» вопреки всем ожиданиям выдают страницы «единство ЮРИДИЧЕСКОЙ терминологии». Но о единой унифицированной терминологии в системе стандартизации в поисковой выдаче практически ничего нет. И это очень плохо. Почему так? Редакция от 18.12.2024.

Во всех системах документации имеются стандарты, содержащие общие требования к текстовым документам и регламентирующие их оформление. В ЕСПД это ГОСТ 19.106–78, в ЕСКД — ГОСТ 2.105–95 и ГОСТ Р 2.105–2019, в СИБИД — ГОСТ 7.32–2001. Ну и так далее.

В каждом из перечисленных стандартов одна и та же тягомотина: абзацный отступ столько–то миллиметров, междустрочный интервал — такой–то, рамки (основная надпись) — еще какие–то...

А вот нахрена это надо? Чтобы кормить нормоконтролеров? Неужели так трудно прикрутить к официальному изданию стандарта готовый шаблон на все случаи жизни, дабы каждый разработчик мог его скачать и тупо пользоваться, не озадачиваясь разработкой собственных шаблонов согласно всей этой хрени? Редакция от 13.12.2024.