FM
Все только на доклада говорят о том, как сделать документ user frendly, а как дело доходит до ревью - сразу стоп холд и указание написать так, что бы не было ни понятно, ни удобно
Size: a a a
2019 March 05
OI
Fox Mulder
Никому такая документация в ру сегменте не нужна. Это западный стиль подачи контента и в наших ареалах он не применим.
это какая?
НН
Я открыл и тож не оч уловил, вроде всё как всегда
НН
Но красивее
s
Меня вполне устраивает такая документация по продукту
OI
Я что-то не просекла тезис "такая документация в ру сегменте не нужна". Просто я смотрю на себя, я в ру сегменте, мне нужна. Что не так?
OI
Я надеюсь, что Фокс нам сейчас все объяснит
NV
Fox Mulder
Все только на доклада говорят о том, как сделать документ user frendly, а как дело доходит до ревью - сразу стоп холд и указание написать так, что бы не было ни понятно, ни удобно
Это от кого такое ревью и указания?
AS
Fox Mulder
https://nova.laravel.com/docs/1.0/installation.html - вот отличный прмер документации
> Nova supports reasonably recent versions of the following browsers
Такое норм воспринимается в современном мире документации?🤷🏻♀️
Такое норм воспринимается в современном мире документации?🤷🏻♀️
FM
А что ссылка на пост не прицепилась?
NV
> Nova supports reasonably recent versions of the following browsers
Такое норм воспринимается в современном мире документации?🤷🏻♀️
Такое норм воспринимается в современном мире документации?🤷🏻♀️
Ну так себе, но это может быть осознанным компромиссом. После каждого релиза проверять поддерживаемые версии браузеров и обновлять документ — это дорого.
FM
Мне с телефона не удобно. Почему у нас вся документация делается так, чтобы её было неприятно читать и что бы там ничего не было понятно
NV
Это ж не дистрибутивы линукса, которые выходят раз в полгода-год. Браузеры меняются постоянно.
NV
Fox Mulder
Никому такая документация в ру сегменте не нужна. Это западный стиль подачи контента и в наших ареалах он не применим.
По вашим словам получается, что западный стиль у нас неприменим, остаётся неприятно-непонятный стиль.
NV
Вы лично как хотите писать?
FM
Как раз понятный. Стиль официоща и фоомализма
FM
Т9
FM
Я хочу писать для людей, а не для галочки, что документ есть. Как мне как то сказал один топ - документацию надо писать так, что бы никто не хотел её читать
NV
Ну так в России куча компаний пишет доки для людей. Приходите к ним работать.
NV
Fox Mulder
Мне с телефона не удобно. Почему у нас вся документация делается так, чтобы её было неприятно читать и что бы там ничего не было понятно
