Size: a a a

DocOps-сообщество

2019 August 29

FM

Fox Mulder in DocOps-сообщество
Nick Volynkin
Будет трансляция (правда, на ВК) и потом записи на Ютубе
Отлично! Ждем запись на ютубе!
источник

RG

Ramil G in DocOps-сообщество
Коллеги, поделитесь опытом как хранить и распространять артефакты документации. Исходные законодательные акты, входящие письма заказчика, протоколы совещаний. Сейчас это в почте, но если честно - задолбало
источник

RG

Ramil G in DocOps-сообщество
Ramil G
Коллеги, поделитесь опытом как хранить и распространять артефакты документации. Исходные законодательные акты, входящие письма заказчика, протоколы совещаний. Сейчас это в почте, но если честно - задолбало
Конфлюенс имеется, но он недоступен без ВНП и интернета. Думаю может кто хранит в гит+Hugo? Чтобы при синхронизации прилетал обновленный сайт в виде HTML для работы в офлайне
источник

NV

Nick Volynkin in DocOps-сообщество
Ramil G
Конфлюенс имеется, но он недоступен без ВНП и интернета. Думаю может кто хранит в гит+Hugo? Чтобы при синхронизации прилетал обновленный сайт в виде HTML для работы в офлайне
А электропочта разве доступна без ВПН и интернета?
источник

RG

Ramil G in DocOps-сообщество
Nick Volynkin
А электропочта разве доступна без ВПН и интернета?
Да.
источник

А

Александр in DocOps-сообщество
Всем привет, кто то пишет доку для kotlin проектов? Поделитесь инструментарием
источник

AS

Alenka Shvedova in DocOps-сообщество
Nick Volynkin
Будет трансляция (правда, на ВК) и потом записи на Ютубе
А утром ссылка будет на трансляцию? Я проснусь :)
источник

OP

Olga Platonova in DocOps-сообщество
Подскажите про toctree и sphinx, начала работать с ним недавно.
Хочу собрать содержание из документов, лежащих на уровень выше чем сам проект и файл index, как включить их? команда формата
.. toctree::
  ../file
не работает, ошибка reference to nonexisting document
Можно ли вообще включать файлы, лежащие за директорией проекта?
Если нет, как создать несколько проектов, использующих одни и те же исходники, но в разной компоновке?
источник

L

Lana in DocOps-сообщество
Olga Platonova
Подскажите про toctree и sphinx, начала работать с ним недавно.
Хочу собрать содержание из документов, лежащих на уровень выше чем сам проект и файл index, как включить их? команда формата
.. toctree::
  ../file
не работает, ошибка reference to nonexisting document
Можно ли вообще включать файлы, лежащие за директорией проекта?
Если нет, как создать несколько проектов, использующих одни и те же исходники, но в разной компоновке?
положите index.rst в корень, тогда можно будет брать из любой директории. наружу директории он не умеет выходить по умолчанию
источник

L

Lana in DocOps-сообщество
вот как-то так
.. toctree::
  :maxdepth: 1
  :glob:

  file/*
источник

SR

Stas Rychkov in DocOps-сообщество
Тут на реддите пробегала тема насчёт курсов. Питон, задачки, всё такое.

И там рекомендации такие.

https://www.freecodecamp.org/
https://codeforces.com/problemset
https://ocw.mit.edu/index.htm
https://www.codecademy.com/
https://www.sololearn.com/
https://pythonprogramming.net/tokenizing-words-sentences-nltk-tutorial/ (тут не удержусь и кину сразу на тему текста)
https://stepik.org/catalog
https://codingbat.com/python
https://www.dataquest.io/

KhanAcademy, Udemy, Coursera сами собой.

А что бы вы добавили в этот список?
источник

НН

Нац Нац in DocOps-сообщество
Stas Rychkov
Тут на реддите пробегала тема насчёт курсов. Питон, задачки, всё такое.

И там рекомендации такие.

https://www.freecodecamp.org/
https://codeforces.com/problemset
https://ocw.mit.edu/index.htm
https://www.codecademy.com/
https://www.sololearn.com/
https://pythonprogramming.net/tokenizing-words-sentences-nltk-tutorial/ (тут не удержусь и кину сразу на тему текста)
https://stepik.org/catalog
https://codingbat.com/python
https://www.dataquest.io/

KhanAcademy, Udemy, Coursera сами собой.

А что бы вы добавили в этот список?
Я когда-то работал в checkio, там питонячьих задачек креативных было валом. Даже удалось Гвидо Ван Россума пригласить поревьювить решения юзеров
источник

SR

Stas Rychkov in DocOps-сообщество
Нац Нац
Я когда-то работал в checkio, там питонячьих задачек креативных было валом. Даже удалось Гвидо Ван Россума пригласить поревьювить решения юзеров
👍
источник

v

vladimir in DocOps-сообщество
источник

M

Maxim in DocOps-сообщество
Книга Лутца и codewars дают хорошую базу и небольшой опыт
источник

SY

Sofia Yemelianova in DocOps-сообщество
Olga Platonova
Подскажите про toctree и sphinx, начала работать с ним недавно.
Хочу собрать содержание из документов, лежащих на уровень выше чем сам проект и файл index, как включить их? команда формата
.. toctree::
  ../file
не работает, ошибка reference to nonexisting document
Можно ли вообще включать файлы, лежащие за директорией проекта?
Если нет, как создать несколько проектов, использующих одни и те же исходники, но в разной компоновке?
Создайте файл-плейсхолдер на уровне индекса и вставьте туда include:: ../file
источник

SY

Sofia Yemelianova in DocOps-сообщество
точнее так:
- в index.srt
  .. toctree::

     placeholder.rst

- в placeholder.rst:
  Some title
  =======

  .. inclide:: /path/to/file.rst
источник

SY

Sofia Yemelianova in DocOps-сообщество
еще можно markdown файлы заинклюдить в rst доки, но надо подключить плагин https://pypi.org/project/m2r/ и использовать директиву mdinclude
источник

SY

Sofia Yemelianova in DocOps-сообщество
а еще можно симлинки попробовать, но не факт, что сработает
источник

OP

Olga Platonova in DocOps-сообщество
Sofia Yemelianova
Создайте файл-плейсхолдер на уровне индекса и вставьте туда include:: ../file
точно, кажется это самый простой и подходящий вариант для моей задачи. включение md в rst тоже пригодится, спасибо
источник