https://mobile.opennet.me/openforum/vsluhforumID3/109511.html На kernel.org появился (https://kernel.org/doc/html/latest/) новый раздел с документацией к ядру Linux, для создания которого использован пакет Sphinx (http://www.sphinx-doc.org/). В отличие от ранее предлагаемого набора текстовых файлов, новая документация благодаря добавлению в текст разметки reStructuredText (https://ru.wikipedia.org/wiki/ReStructuredText) (RST), переведена в гипертекстовое представление и отформатирована для удобного чтения. Также сообщается (https://blogs.s-osg.org/documenting-linux-kernel-development-process/) о переводе на Sphinx ряда документов (https://mchehab.fedorapeople.org/kernel_docs/) для разработчиков ядра, рассказывающих об особенностях процесса разработки и организации работы в сообществе.<br><br><br><br><br><br><br><br><br><br><br><br><br>URL: http://lwn.net/Articles/704942/rss<br>Новость: http://www.opennet.ru/opennews/art.shtml?num=45393<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#33 Thu, 03 Nov 2016 08:21:19 GMT &gt;&gt; единой спецификации до сих пор никто не сделал.<br>&gt; http://commonmark.org/ <br><br>AFAIK, даже гитхабчик ей не следует.<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#32 Thu, 03 Nov 2016 02:27:06 GMT &gt; единой спецификации до сих пор никто не сделал.<br><br>http://commonmark.org/<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#31 Wed, 02 Nov 2016 18:56:55 GMT &gt; Нужда в спецсофте - жирный минус. <br><br>Еще один любитель читать LaTeX на ночь?<br><br>&gt; Особенно для документации, что ни говори. <br><br>Документация - вообще штука сложная. Перекрестные ссылки, параметры/аргументы/аттрибуты функций/методов/классов, примеры, уже помянутая к ночи математика. Просто посмотрите numpydoc, в качестве примера того что людям на практике нада.<br><br>Вы действительно предпочтете это читать из текстового файла, вместо того, чтобы "спецсофтом" сгенерировать православную хтмлку?<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#30 Wed, 02 Nov 2016 18:48:09 GMT &gt; Org-mode - это нехилый комбайн, который может значительно больше, нежели просто <br>&gt; форматирование текста.<br><br>Ах, это. Нет, тут я понимаю, просто подумал речь шла о каких-то приемуществах форматирования.<br><br><br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#29 Mon, 31 Oct 2016 14:08:32 GMT CSS тамошний свои шрифты навязывает.<br>Больше (пока) не нашёл, чему придраться ;) Читаемость++<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#28 Mon, 31 Oct 2016 13:23:42 GMT Может еще и до TeXа дойдут. На ночь читать можно будет...<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#27 Mon, 31 Oct 2016 09:07:30 GMT &gt;&gt; Для себя же пользую Org <br>&gt; А в чем приемущества, vs md в читабельности? Мне казалось, это <br>&gt; тоже очень специальный текстовый формат + заточенный под специфические задачи.<br><br>В читабельности между вышеописанными форматами разницы нет. Разница заключается в редактировании. Org-mode - это нехилый комбайн, который может значительно больше, нежели просто форматирование текста.<br><br>Он может облегчить планирование задач, создание TODO-шек, автогенерацию агенды, разные виды секционирования: выпадающие списки, проставление зависимостей между задачами, выставление дедлайнов и настройка повторяющихся событий.<br><br>В дополнение к стандартной части в виде табличек, параграфов, ссылок и т.п. вышеперечисленные - это очень круто.<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#26 Sun, 30 Oct 2016 20:51:36 GMT Можешь пересобрать с другой темой же.<br> https://mobile.opennet.me/openforum/vsluhforumID3/109511.html#25 Sun, 30 Oct 2016 18:17:23 GMT Нужда в спецсофте - жирный минус. Особенно для документации, что ни говори.<br>