Отлично! Ждем запись на ютубе!

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

Конфлюенс имеется, но он недоступен без ВНП и интернета. Думаю может кто хранит в гит+Hugo? Чтобы при синхронизации прилетал обновленный сайт в виде HTML для работы в офлайне

А электропочта разве доступна без ВПН и интернета?

Да.

Всем привет, кто то пишет доку для kotlin проектов? Поделитесь инструментарием

А утром ссылка будет на трансляцию? Я проснусь :)

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

положите index.rst в корень, тогда можно будет брать из любой директории. наружу директории он не умеет выходить по умолчанию

вот как-то так
.. toctree::
  :maxdepth: 1
  :glob:

  file/*

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

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

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, там питонячьих задачек креативных было валом. Даже удалось Гвидо Ван Россума пригласить поревьювить решения юзеров

👍

книга: http://itexts.net/files/pdf/douson-maykl-programmiruem-na-python.-279065.pdf

Книга Лутца и codewars дают хорошую базу и небольшой опыт

Создайте файл-плейсхолдер на уровне индекса и вставьте туда include:: ../file

точнее так:
- в index.srt
  .. toctree::

     placeholder.rst

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

  .. inclide:: /path/to/file.rst

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

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

точно, кажется это самый простой и подходящий вариант для моей задачи. включение md в rst тоже пригодится, спасибо