Size: a a a

2020 March 10

J

Jonny Cuba in technicalwriters
Nick Volynkin
Переменные в каком контексте? В конфигах? Переменные окружения? Переменные в классе в какой-то библиотеке?
переменные окружения
источник

J

Jonny Cuba in technicalwriters
Переменные и методы
источник

NV

Nick Volynkin in technicalwriters
и методы окружения?
источник

J

Jonny Cuba in technicalwriters
да
источник

NV

Nick Volynkin in technicalwriters
Вот неплохой пример доки по переменным окружения. https://docs.docker.com/compose/reference/envvars/
источник

J

Jonny Cuba in technicalwriters
спасибо, что напомнили,  видел это когда-то))
источник

A

Angela in technicalwriters
коллеги, может, есть какие-либо методы для просмотра абсолютно всех изменений в документе в гугл докс?
источник

NV

Nick Volynkin in technicalwriters
Angela
коллеги, может, есть какие-либо методы для просмотра абсолютно всех изменений в документе в гугл докс?
Там же вроде есть просмотр изменений
источник

A

Angela in technicalwriters
Nick Volynkin
Там же вроде есть просмотр изменений
только той ветки, когда открывал какой-либо пользователь и редактировал, мне нужны все изменения от всех пользователей за всё время работы над документом
источник

KC

Kseniya Chudakova in technicalwriters
Всем привет! Подскажите, есть ли готовая тулза(скриптик), которая собирает единый документ .md из разных репозиториев?
источник
2020 March 11

ЕР

Елена Речкина in technicalwriters
Всем привет! Занимаюсь переносом документации на ПО (не python проект) с ворда на ReST.
Подскажите, как в sphinx можно ссылаться на файлы .rst, которые лежат не в корневом каталоге вместе с index.rst?
Выдает такую ошибку «WARNING: toctree contains reference to nonexisting document <имя файла>».
источник

NV

Nick Volynkin in technicalwriters
Елена Речкина
Всем привет! Занимаюсь переносом документации на ПО (не python проект) с ворда на ReST.
Подскажите, как в sphinx можно ссылаться на файлы .rst, которые лежат не в корневом каталоге вместе с index.rst?
Выдает такую ошибку «WARNING: toctree contains reference to nonexisting document <имя файла>».
:doc:`relative/path/file`
:doc:`/absolute/path/file`
:doc:`../other-directory/file`

https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-documents
источник

NV

Nick Volynkin in technicalwriters
Да, и обязательно используйте pandoc, не переносите руками.
источник

ЕР

Елена Речкина in technicalwriters
спасибо) буду пробовать
источник

NV

Nick Volynkin in technicalwriters
Елена Речкина
спасибо) буду пробовать
Будут ещё вопросы — обращайтесь. И в @docsascode заходите )
источник

NV

Nick Volynkin in technicalwriters
Nick Volynkin
:doc:`relative/path/file`
:doc:`/absolute/path/file`
:doc:`../other-directory/file`

https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-documents
тут были лишние расширения файлов .rst, убрал
источник

F

Femme pas fatale in technicalwriters
#tw_wanted #вакансия Московские коллеги, приветствую! Нам в команду нужен документатор с опытом в аналитике или стремлением развивать данный скилл. У нас стабильный госзаказ, один большой и долгоиграющий проект по поддержке госсистемы и разовые проекты, так же связанные с госзаказом (цифровизация). Что мы можем предложить: зарплата по рынку, но все обсуждаемо при личной встрече; хороший соцпакет; молодой и амбициозный коллектив; гарантированная возможность роста, очень интересные проекты с возможностью проявить себя и получить уникальный опыт. Что мы ждем от кандидата: оперативное погружение в предметную область, работа с технической документацией, в том числе проектной документацией; ГОСТ не строго, но рекомендательно; разработка материалов под сертификацию ФСТЭК, знание ИБ-шной нормативки; умение разбираться в архитектуре продукта, понимать код. Профильное ИТ-образование обязательно. Обращайтесь в личку за подробностями.
источник

AU

Anastasia Uskova in technicalwriters
#вакансия  #москва #офис #fulltime #ipchain #wanted_tw

🔘Технический писатель
• вилка: 70 000-100 000 рублей, ТК РФ
• опыт работы: от года

🔘Необходимые навыки:
•опыт разработки проектной, технической и пользовательской документации;
•понимание идеи разработки документации по принципу единого источника.

🔘Задачи внутри команды:
•разработка, систематизация и поддержка в актуальном состоянии технической, эксплуатационной и пользовательской документации, а также регламентных документов;
•участие в разработке и внедрении шаблонов документов различного назначения;
•взаимодействие с командой.

🔘Продукт: IPEX — это цифровая платформа, которая позволяет создателям и пользователям объектов интеллектуальной собственности найти друг друга и взаимодействовать напрямую. https://ipex.global

🔘Мы предлагаем:
•возможность влиять на продукт;
•agile управление проектами: Scrum и Kanban;
•возможность развиваться;
•соблюдение ТК РФ;
•гибкий старт начала рабочего дня (9:00 - 11:00);
•офис 7 минут пешком от м. Савеловская.

🔘Контакты: @uskova_hr
источник

L

Lana in technicalwriters
Nick Volynkin
:doc:`relative/path/file`
:doc:`/absolute/path/file`
:doc:`../other-directory/file`

https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#cross-referencing-documents
Для ... надо чтобы index.rst лежал в корне, он выше места, где лежит индекс не пойдёт, у меня была такая засада.
источник

ЕР

Елена Речкина in technicalwriters
Lana
Для ... надо чтобы index.rst лежал в корне, он выше места, где лежит индекс не пойдёт, у меня была такая засада.
Как вы решили этот вопрос? У меня пока не получается, я - новичок пока в этом, только в начале пути.
источник