Size: a a a

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

2020 October 20

VI

Vladimir Izmalkov in DocOps-сообщество
Спасибо, прикольно
источник

DB

Dima Boger in DocOps-сообщество
iakov v
в gettext, кстати, огромное количество "граблей" и "подводных камней" локализации решено. странно, что это всё ещё не самая популярная штука для локализации
Далеко не все :( Гендер не учитывает, например
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
iakov v
в gettext, кстати, огромное количество "граблей" и "подводных камней" локализации решено. странно, что это всё ещё не самая популярная штука для локализации
И ряд граблей не решен, вроде того что ключ равен строке "базовой" локали, от которой нужно плясать, что мешает, когда логика у языков локализации сильно разная

Если искать самый чистый и выразительный формат, я б сказал Project Fluent бодрее будет
https://www.projectfluent.org/fluent/guide/

Хотя gettext, конечно, выигрывает по распространённости и поддержке инструментами
источник

iv

iakov v in DocOps-сообщество
Да, нет в мире совершенства
источник
2020 October 21

A

Angela in DocOps-сообщество
а есть кто-то, разбирающийся в конфигурации nginx? как настроить редиректы на latest, что-то не получается
источник

LZ

Lev Zabudko in DocOps-сообщество
Можно же ссылаться на дирректорию в проксипассе, а остальное дополнять в url в браузере. Тогда удрес из проксипасса будет вести на каталог какой-то, а если там лежит файл latest.html, допустим, то дописав в url это значение вам будет отдан этот файл
источник

iv

iakov v in DocOps-сообщество
Angela
а есть кто-то, разбирающийся в конфигурации nginx? как настроить редиректы на latest, что-то не получается
пришлите мне в личку вашу конфигурацию, что хочется получить и что получается на самом деле, я могу глянуть
источник

A

Angela in DocOps-сообщество
Lev Zabudko
Можно же ссылаться на дирректорию в проксипассе, а остальное дополнять в url в браузере. Тогда удрес из проксипасса будет вести на каталог какой-то, а если там лежит файл latest.html, допустим, то дописав в url это значение вам будет отдан этот файл
вроде всё заработало 😅
кеш сбросила
источник

A

Angela in DocOps-сообщество
iakov v
пришлите мне в личку вашу конфигурацию, что хочется получить и что получается на самом деле, я могу глянуть
спасибо) пока работает
источник

PD

Phil Delgyado in DocOps-сообщество
Vadim Smelyanskiy
И ряд граблей не решен, вроде того что ключ равен строке "базовой" локали, от которой нужно плясать, что мешает, когда логика у языков локализации сильно разная

Если искать самый чистый и выразительный формат, я б сказал Project Fluent бодрее будет
https://www.projectfluent.org/fluent/guide/

Хотя gettext, конечно, выигрывает по распространённости и поддержке инструментами
А почему не JSON с поддержкой ICU? Я в результате его выбрал, как гибкий и нормально поддерживаемый.
источник
2020 October 22

AR

Anna Ryutina in DocOps-сообщество
подскажите как закомментировать код в markdown, у меня что-то не выходит
источник

EP

Elena Parameshwari in DocOps-сообщество
Anna Ryutina
подскажите как закомментировать код в markdown, у меня что-то не выходит
технически, в МД нет понятия комментария, мы обошли "пустой ссылкой"
источник

AR

Anna Ryutina in DocOps-сообщество
да я брала отсюда, получилось, но не сразу спс)
источник

RG

Ramil G in DocOps-сообщество
Anna Ryutina
подскажите как закомментировать код в markdown, у меня что-то не выходит
Комментится как и html <!-- любой текст -->
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
источник
2020 October 25

ML

Maksim Lapshin in DocOps-сообщество
Какие есть годные инструменты для документирования схемы данных.

У меня сейчас два набора:  это одна большая схема из пачки вложенных типов, примерно на 2000 полей и ещё 200 отдельных небольших типов.

Сами типы можно представить в виде JSON schema, можно по-другому если надо.

Для json-schema я нашел адобовский и cloudflare инструменты, оба из которых требуют допила.

Кто чем пользуется?
источник
2020 October 26

a

akater in DocOps-сообщество
Maksim Lapshin
Какие есть годные инструменты для документирования схемы данных.

У меня сейчас два набора:  это одна большая схема из пачки вложенных типов, примерно на 2000 полей и ещё 200 отдельных небольших типов.

Сами типы можно представить в виде JSON schema, можно по-другому если надо.

Для json-schema я нашел адобовский и cloudflare инструменты, оба из которых требуют допила.

Кто чем пользуется?
Это конешно интересный вопрос, и я каждый раз в итоге пишу что-то свое, и подозреваю, что иначе-то и не бывает.  Точно так же, как не существует алгоритма для сравнения произвольных объектов (а «схема» это уже достаточно широко), не будет и алгоритма для произвольной их документации.
источник

ML

Maksim Lapshin in DocOps-сообщество
akater
Это конешно интересный вопрос, и я каждый раз в итоге пишу что-то свое, и подозреваю, что иначе-то и не бывает.  Точно так же, как не существует алгоритма для сравнения произвольных объектов (а «схема» это уже достаточно широко), не будет и алгоритма для произвольной их документации.
Звучит необнадеживаюше, но по крайней мерк обьясняет, почему нет 100 готовых инструментов
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Maksim Lapshin
Какие есть годные инструменты для документирования схемы данных.

У меня сейчас два набора:  это одна большая схема из пачки вложенных типов, примерно на 2000 полей и ещё 200 отдельных небольших типов.

Сами типы можно представить в виде JSON schema, можно по-другому если надо.

Для json-schema я нашел адобовский и cloudflare инструменты, оба из которых требуют допила.

Кто чем пользуется?
TypeScript + TSDoc

Сначала казалось, что делаем что-то не то, используя язык программирования для документации, а потом как-то пришло смирение, что богаче и гибче систему типов мы не найдём
источник

ML

Maksim Lapshin in DocOps-сообщество
Vadim Smelyanskiy
TypeScript + TSDoc

Сначала казалось, что делаем что-то не то, используя язык программирования для документации, а потом как-то пришло смирение, что богаче и гибче систему типов мы не найдём
Оу, интересно, посмотрю
источник