Вопросы с тегом «documentation»

48
Как вы документируете свою работу, процессы и окружающую среду?

Вы используете формат вики? Если да, то какой продукт? (MediaWiki, Confluence, Sharepoint и т. Д.) Вы создали базу знаний? (Проблемные / ориентированные на решение короткие документы.) Какие проблемы возникают у вас с созданием работающей документации, чтобы вам не звонили, когда вы уезжаете в...

27
Если бы вас сбил автобус, у вашей компании были бы проблемы?

Locked . Этот вопрос и его ответы заблокированы, потому что вопрос не по теме, но имеет историческое значение. В настоящее время он не принимает новые ответы или взаимодействия. На работе я единственный IT-парень (делай все, и делай это сейчас, типа парень) за последние 10 лет. Если бы я...

21
Начало работы с документацией

Мы не делали никакой документации на моем рабочем месте. Я совершенно новичок в этом вопросе и прошу несколько советов по началу работы. У меня есть несколько вопросов: Каковы основные документы, которые системный администратор должен написать и поддерживать? И почему это так важно? Как вы...

17
Документация как руководство по сравнению с документацией как контрольный список

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

16
Как я пишу справочные страницы? [закрыто]

Закрыто . Этот вопрос должен быть более сфокусированным . В настоящее время не принимает ответы. Закрыто 5 лет назад . Locked . Этот вопрос и его ответы заблокированы, потому что вопрос не по теме, но имеет историческое значение. В настоящее время он не принимает новые ответы или взаимодействия....

15
Как вы документируете конфигурации сервера Windows?

Я пришел из истории Unix, где документирование конфигурации службы (например, электронной почты) может быть таким же простым, как захват нескольких текстовых файлов конфигурации и параграфа или 2 пояснительного текста. Столкнувшись с документированием конфигурации многих (более 50) блоков Windows,...

14
ИТ-документация с MediaWiki

Мы ищем способы дальнейшего совершенствования нашей документации и возможности обеспечить легкий доступ к информации, а также ее редактирование. Помня об этих идеях, мы создали внутреннюю вики на основе платформы MediaWiki для нашего уровня 1 (Help Desk). Это было огромным успехом для службы...

13
бесплатный инструмент для документации центра обработки данных [закрыто]

Закрыто. Этот вопрос не по теме . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он соответствовал теме отказа сервера. Закрыто 7 лет назад . Существуют ли какие-либо бесплатные инструменты, которые могут помочь лучше документировать в центре...

13
Где я могу документировать полезные вещи, которые нужно знать как системный администратор Mac?

Недавно я провел некоторые исследования по инструментам службы каталогов на Mac (dscl, dsimport, dsexport) и хотел бы иметь возможность документировать их где-нибудь для всех (и, возможно, там, где моя работа может быть улучшена). Я не вижу никакого преимущества в создании собственного сайта для...

12
Как документировать конфигурацию сервера Linux?

У меня есть около 20 серверов Linux, которые мне нужны для документирования конфигурации. Я имею в виду не детальную конфигурацию служб, а скорее учетные записи пользователей, базы данных, учетные записи баз данных, IP-адреса, физическое местоположение, порт SSH и т. Д. И т. Д. Я знаю, что все эти...

12
Все, что близко к Руководству АНБ по обеспечению безопасности RHEL 6 [закрыто]

Закрыто. Этот вопрос не по теме . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он соответствовал теме отказа сервера. Закрыто 5 лет назад . Некоторые в нашей инфраструктурной группе хотят обновить систему, чтобы начать использовать преимущества...

11
Отраслевые стандарты для маркировки сетевой инфраструктуры

Существуют ли какие-либо действующие отраслевые стандарты IEEE, ISO, ANSI ...., в которых указано, как следует маркировать физическую инфраструктуру здания на стойке и домкрате и как должна быть оформлена документация? Я знаю, что есть IEEE Std 200, но он устарел, и я нашел стандарт ASME для...

11
Ищете хорошую документацию по файлам odbc.ini и odbcinst.ini в Linux

Я видел частичную информацию, старую информацию, но ничего лучше, чем настоящие примеры файлов с краткими комментариями, которые есть у меня на месте. Мне нужно понять точные отношения между odbc.iniи odbcinst.ini. Внешне это довольно очевидно - в верхней части odbc.iniфайла есть такой раздел:...

9
Что важно документировать на активном сервере каталогов?

Позже в этом году я передам поддержку активных серверов каталогов моей церкви кому-то еще и хотел бы знать, какую информацию важно документировать и делиться. Есть ли хорошие примеры документов, которые я мог бы...

8
Какой уровень документации вы ожидаете предоставить разработчикам?

Locked . Этот вопрос и его ответы заблокированы, потому что вопрос не по теме, но имеет историческое значение. В настоящее время он не принимает новые ответы или взаимодействия. Название говорит обо всем на самом деле. Иногда может случиться так, что развитие и ИТ находятся в ссоре из-за такого...

8
Как избежать того, чтобы документация сервера не синхронизировалась с фактической настройкой?

У нас есть достаточно хорошая документация для нашей среды (в формате AsciiDoc), которая недавно позволила другому человеку воссоздать всю установку с нуля менее чем за 30 минут. Тем не менее, я заметил, что после первоначальной настройки легко случается, что в систему вносятся небольшие изменения...