Size: a a a

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

2020 January 24

НН

Нац Нац in DocOps-сообщество
Семён Факторович
а я снова про линтеры:

какие именно ошибки вы выявляете линтерами?
Стиль время weasel words
источник

НН

Нац Нац in DocOps-сообщество
Voice
источник

НН

Нац Нац in DocOps-сообщество
Passive active
источник

СФ

Семён Факторович in DocOps-сообщество
Нац Нац
Стиль время weasel words
время — как, например?
источник

НН

Нац Нац in DocOps-сообщество
Там здоровые
источник

НН

Нац Нац in DocOps-сообщество
Регулярки
источник

НН

Нац Нац in DocOps-сообщество
Ща я в Кабинет зашёл ток, но зайди в testthedocs и открой любой рул, они называются логично и внутри понятны
источник

НН

Нац Нац in DocOps-сообщество
Плюс новомодные they them, master slave и прочее гендерно нейтральное всячество
источник

L

Lex in DocOps-сообщество
Семён Факторович
время — как, например?
На слово "will" ругается, что не надо использовать будущее время в доке
источник

СФ

Семён Факторович in DocOps-сообщество
Нац Нац
Плюс новомодные they them, master slave и прочее гендерно нейтральное всячество
оо, точняк, спасибо!
источник

НН

Нац Нац in DocOps-сообщество
Lex
На слово "will" ругается, что не надо использовать будущее время в доке
Только если доки про железо, там Мона вроде
источник

L

Lex in DocOps-сообщество
Семён Факторович
а я снова про линтеры:

какие именно ошибки вы выявляете линтерами?
Title case. Чтоб заголовки были единообразны
источник

L

Lex in DocOps-сообщество
Нац Нац
Только если доки про железо, там Мона вроде
Нам в сдк-шечках запретили будущее
источник

L

Lex in DocOps-сообщество
Но если очень хочется, то можно 😁
источник

СФ

Семён Факторович in DocOps-сообщество
мне в первую очередь придумались:
- пунктуация в списках (как в русском, так и в английском)
- капитализация заголовков в английском (sentence style или newspaper style, у кого что принято)
- капитализация аббревиатур
- проблемы с вайтспейсом (лишние пробелы в конце, отсутствие пробела после пунктуации и пр.)
источник

НН

Нац Нац in DocOps-сообщество
Всевозможный антропоморфизм
источник

НН

Нац Нац in DocOps-сообщество
Типа computer sees the directory
источник

НН

Нац Нац in DocOps-сообщество
Не стоит
источник

iv

iakov v in DocOps-сообщество
Нац Нац
Типа computer sees the directory
а разве линтер может такое выловить?
источник

НН

Нац Нац in DocOps-сообщество
iakov v
а разве линтер может такое выловить?
Конечно, регулярки и токены!
источник