T
Аутсорсный проект был, приостановили.
Size: a a a
2020 April 06
S
У меня также. Официально заявили, что "проект ставят на паузу". Попробую искать на иночтранных фриланс-биржах
T
Для меня то была дополнительная нагрузка. Основная работа осталась, нагрузки даже больше стало.
ДС
Есть проект со знакомыми врачами, сейчас пока поставили на паузу
ЕР
всем привет! Подскажите как в sphinx сформировать toctree так, чтобы описание модуля 2 было подпунктом в дереве навигации модуля 1? Если наглядно, то как сделать "Geoserver" подпунктом "Установка дополнительного ПО"?
Я пока только начинаю работу в сфинксе и rst.
Я пока только начинаю работу в сфинксе и rst.
L
всем привет! Подскажите как в sphinx сформировать toctree так, чтобы описание модуля 2 было подпунктом в дереве навигации модуля 1? Если наглядно, то как сделать "Geoserver" подпунктом "Установка дополнительного ПО"?
Я пока только начинаю работу в сфинксе и rst.
Я пока только начинаю работу в сфинксе и rst.
можно убрать его из общего toc и сделать локальный ток внутри страницы установка дополнительного по на сервере
ЕР
локальный toc делается внутри страницы "установка доп ПО на сервере" через .. toctree:: или это отдельный файл типа index, который лежит в папке с описанием "Установка доп ПО на сервере"?, есть еще директива contents. Чем они отличаются, я не поняла пока.
2020 April 07
СФ
---
В эту пятницу, 10 апреля, я стартую очередной сезон своего онлайн-курса «Техническая документация в IT-проектах», http://documentat.io/courses/open-course/
(если вы уже слушали этот курс в 2017-2018 годах, то послушайте еще раз: в этом году он сильно поменялся)
Этот курс в первую очередь о процессах документирования: об их целеполагании и их месте в общей картине процессов разработки ПО.
Формат курса — еженедельные лекции (по пятницам в 9:00 Мск) на 40-50 минут каждая, транслируемые на YouTube. Курс будет состоять из 7-10 лекций (как пойдет).
О чем мы будем говорить:
- Цели и задачи документации с точки зрения проектного управления.
- Жизненные циклы технических документов. Процессы создания, рецензирования, хранения и публикации документации.
- Типичные виды инструментария создания, хранения и публикации документации. Их сравнение с точки зрения применимости к разным видам документационных процессов.
- Обзор современных документационных стандартов (ГОСТ и ISO/IEC/IEEE).
- Профессиональный профиль технического писателя. Что нужно, чтобы быть хорошим техписателем, куда расти опытному техписателю, как нанимать их себе в команду.
Курс бесплатный, присоединиться можно в любой момент, но необходима регистрация.
Присоединяйтесь! http://documentat.io/courses/open-course/
В эту пятницу, 10 апреля, я стартую очередной сезон своего онлайн-курса «Техническая документация в IT-проектах», http://documentat.io/courses/open-course/
(если вы уже слушали этот курс в 2017-2018 годах, то послушайте еще раз: в этом году он сильно поменялся)
Этот курс в первую очередь о процессах документирования: об их целеполагании и их месте в общей картине процессов разработки ПО.
Формат курса — еженедельные лекции (по пятницам в 9:00 Мск) на 40-50 минут каждая, транслируемые на YouTube. Курс будет состоять из 7-10 лекций (как пойдет).
О чем мы будем говорить:
- Цели и задачи документации с точки зрения проектного управления.
- Жизненные циклы технических документов. Процессы создания, рецензирования, хранения и публикации документации.
- Типичные виды инструментария создания, хранения и публикации документации. Их сравнение с точки зрения применимости к разным видам документационных процессов.
- Обзор современных документационных стандартов (ГОСТ и ISO/IEC/IEEE).
- Профессиональный профиль технического писателя. Что нужно, чтобы быть хорошим техписателем, куда расти опытному техписателю, как нанимать их себе в команду.
Курс бесплатный, присоединиться можно в любой момент, но необходима регистрация.
Присоединяйтесь! http://documentat.io/courses/open-course/
FM
Записался!
KC
---
В эту пятницу, 10 апреля, я стартую очередной сезон своего онлайн-курса «Техническая документация в IT-проектах», http://documentat.io/courses/open-course/
(если вы уже слушали этот курс в 2017-2018 годах, то послушайте еще раз: в этом году он сильно поменялся)
Этот курс в первую очередь о процессах документирования: об их целеполагании и их месте в общей картине процессов разработки ПО.
Формат курса — еженедельные лекции (по пятницам в 9:00 Мск) на 40-50 минут каждая, транслируемые на YouTube. Курс будет состоять из 7-10 лекций (как пойдет).
О чем мы будем говорить:
- Цели и задачи документации с точки зрения проектного управления.
- Жизненные циклы технических документов. Процессы создания, рецензирования, хранения и публикации документации.
- Типичные виды инструментария создания, хранения и публикации документации. Их сравнение с точки зрения применимости к разным видам документационных процессов.
- Обзор современных документационных стандартов (ГОСТ и ISO/IEC/IEEE).
- Профессиональный профиль технического писателя. Что нужно, чтобы быть хорошим техписателем, куда расти опытному техписателю, как нанимать их себе в команду.
Курс бесплатный, присоединиться можно в любой момент, но необходима регистрация.
Присоединяйтесь! http://documentat.io/courses/open-course/
В эту пятницу, 10 апреля, я стартую очередной сезон своего онлайн-курса «Техническая документация в IT-проектах», http://documentat.io/courses/open-course/
(если вы уже слушали этот курс в 2017-2018 годах, то послушайте еще раз: в этом году он сильно поменялся)
Этот курс в первую очередь о процессах документирования: об их целеполагании и их месте в общей картине процессов разработки ПО.
Формат курса — еженедельные лекции (по пятницам в 9:00 Мск) на 40-50 минут каждая, транслируемые на YouTube. Курс будет состоять из 7-10 лекций (как пойдет).
О чем мы будем говорить:
- Цели и задачи документации с точки зрения проектного управления.
- Жизненные циклы технических документов. Процессы создания, рецензирования, хранения и публикации документации.
- Типичные виды инструментария создания, хранения и публикации документации. Их сравнение с точки зрения применимости к разным видам документационных процессов.
- Обзор современных документационных стандартов (ГОСТ и ISO/IEC/IEEE).
- Профессиональный профиль технического писателя. Что нужно, чтобы быть хорошим техписателем, куда расти опытному техписателю, как нанимать их себе в команду.
Курс бесплатный, присоединиться можно в любой момент, но необходима регистрация.
Присоединяйтесь! http://documentat.io/courses/open-course/
Ура!
Г
AR
рано, очень, рано
СФ
рано, очень, рано
для тех, кто не смог быть на трансляции, останется запись
OK
Re: Please don't write your documentation in Markdown
This reminds me of a comment on an anti-markdown post I read a few years back.
"As far as I'm concerned the best tool for writing documentation is the one that anyone can actually be bothered to use. Markdown might not be perfect but at least it's simple and commonly understood so there isn't much barrier to writing/updating documentation." - warmans
[1] https://www.reddit.com/r/programming/comments/4ck2lu/why_you_shouldnt_use_markdown_for_documentation/
husarcik, 17 minutes ago
This reminds me of a comment on an anti-markdown post I read a few years back.
"As far as I'm concerned the best tool for writing documentation is the one that anyone can actually be bothered to use. Markdown might not be perfect but at least it's simple and commonly understood so there isn't much barrier to writing/updating documentation." - warmans
[1] https://www.reddit.com/r/programming/comments/4ck2lu/why_you_shouldnt_use_markdown_for_documentation/
husarcik, 17 minutes ago
OK
сорян за избитую тему, прост нашел в закладках(
H
Уже избитая тема.
Мало того, сильно похоже на обычный вброс.
Мало того, сильно похоже на обычный вброс.
2020 April 10
FM
а есть спецы по Swagger2Markup API?
2020 April 13
H
Коллеги, кто-то сталкивался с документированием по теме блокчейнов и прочей дребедени?
H
Это полная дичь или так себе? :)