AY
записал
Size: a a a
2020 January 09
L
Gostdown лучше чем многое, но что за беда с отступами списков?
СИ
очень выручила, когда внезапно заказчик захотел все по ГОСТ)
Вот такую бы штуку но для чисто linux-окружения.... мечты...
НН
Вот такую бы штуку но для чисто linux-окружения.... мечты...
Первое что я сделал, посморел чего там с powershell в линуксе. Вроде всё ок, а вот bat'ники будет проблематично пускать
A
#usedoc
У нас используется sphinx-doc&RST, локализация через gettext и sphinx-intl, система контроля версий GitLab, билд и деплой Docker&Jenkins, веб-сервер nginx
в планах описание REST API из OpenAPI 3.0 через redoc, линтер
У нас используется sphinx-doc&RST, локализация через gettext и sphinx-intl, система контроля версий GitLab, билд и деплой Docker&Jenkins, веб-сервер nginx
в планах описание REST API из OpenAPI 3.0 через redoc, линтер
AZ
Продолжу про инструменты:
#usedoc
Внутренняя документация
- MkDocs (md) с расширениями, Confluence, Swagger
- CI/CD: drone, docker
- bitbucket
- Google Analytics
Пользовательская документация
- Confluence, ScreenSteps, в Word через gostdown
- Яндекс.Метрика
Хочется добавить линтеры и в дальнейшем попробовать Hugo
#usedoc
Внутренняя документация
- MkDocs (md) с расширениями, Confluence, Swagger
- CI/CD: drone, docker
- bitbucket
- Google Analytics
Пользовательская документация
- Confluence, ScreenSteps, в Word через gostdown
- Яндекс.Метрика
Хочется добавить линтеры и в дальнейшем попробовать Hugo
\o/ спасибо!
AZ
#usedoc
У нас используется sphinx-doc&RST, локализация через gettext и sphinx-intl, система контроля версий GitLab, билд и деплой Docker&Jenkins, веб-сервер nginx
в планах описание REST API из OpenAPI 3.0 через redoc, линтер
У нас используется sphinx-doc&RST, локализация через gettext и sphinx-intl, система контроля версий GitLab, билд и деплой Docker&Jenkins, веб-сервер nginx
в планах описание REST API из OpenAPI 3.0 через redoc, линтер
👌
2020 January 10
NK
Контрастная тема в документации
Microsoft сделал в своей документации не только светлую и тёмную темы, но ещё и контрастную. Я впервые встречаю такое и это очень круто, потому что делает сайт доступным для людей с нарушениями зрения.
Вообще, у MS всегда было неплохо с accessibility (a11y, доступностью). Например, с незапамятных времён в Windows была экранная лупа, диктор и увеличенный вдвое интерфейс. Молодцы, ставят высокую планку для всей отрасли.
Microsoft сделал в своей документации не только светлую и тёмную темы, но ещё и контрастную. Я впервые встречаю такое и это очень круто, потому что делает сайт доступным для людей с нарушениями зрения.
Вообще, у MS всегда было неплохо с accessibility (a11y, доступностью). Например, с незапамятных времён в Windows была экранная лупа, диктор и увеличенный вдвое интерфейс. Молодцы, ставят высокую планку для всей отрасли.
rd
ID:
Контрастная тема в документации
Microsoft сделал в своей документации не только светлую и тёмную темы, но ещё и контрастную. Я впервые встречаю такое и это очень круто, потому что делает сайт доступным для людей с нарушениями зрения.
Вообще, у MS всегда было неплохо с accessibility (a11y, доступностью). Например, с незапамятных времён в Windows была экранная лупа, диктор и увеличенный вдвое интерфейс. Молодцы, ставят высокую планку для всей отрасли.
Microsoft сделал в своей документации не только светлую и тёмную темы, но ещё и контрастную. Я впервые встречаю такое и это очень круто, потому что делает сайт доступным для людей с нарушениями зрения.
Вообще, у MS всегда было неплохо с accessibility (a11y, доступностью). Например, с незапамятных времён в Windows была экранная лупа, диктор и увеличенный вдвое интерфейс. Молодцы, ставят высокую планку для всей отрасли.
> Вообще, у MS всегда было неплохо с accessibility (a11y, доступностью). Например, с незапамятных времён в Windows была экранная лупа, диктор и увеличенный вдвое интерфейс.
А ещё контрастная тема в самой винде существует ещё со времён XP.
А ещё контрастная тема в самой винде существует ещё со времён XP.
NV
> Вообще, у MS всегда было неплохо с accessibility (a11y, доступностью). Например, с незапамятных времён в Windows была экранная лупа, диктор и увеличенный вдвое интерфейс.
А ещё контрастная тема в самой винде существует ещё со времён XP.
А ещё контрастная тема в самой винде существует ещё со времён XP.
Ага, да и кастомные темы там можно было делать давно.
NV
Интересно, про что два дизлайка.
VS
Тем временем, тоже документация MS, но в режиме для читалок
VS
Напомню, голосовые читалки веб-страниц читают именно по этой разметке
Т.е. человеку с очень плохим зрением придётся слушать вот эту кашу
Т.е. человеку с очень плохим зрением придётся слушать вот эту кашу
VS
Навигация по доке же не размечена вовсе
NV
Ха, видимо это потому, что там в каждую переведённую строку зашит оригинал ещё.
VS
Похоже на то
NV
Навигация по доке же не размечена вовсе
Вроде вижу теги nav и section. Чего не хватает?
NV
Напомню, голосовые читалки веб-страниц читают именно по этой разметке
Т.е. человеку с очень плохим зрением придётся слушать вот эту кашу
Т.е. человеку с очень плохим зрением придётся слушать вот эту кашу
А голосовые читалки не умеют пропускать элементы с
display: none?VS
Вроде вижу теги nav и section. Чего не хватает?
Не по самому документу нет навигации, а по документации в целом
На другой документ я не вижу как перейти через читалку
На другой документ я не вижу как перейти через читалку
NV
Хм, я всегда думал, что вот этот режим для чтения в Firefox - это просто сам FF фильтрует текст и показывает его со своим CSS.