D
вообще уберите эти оценочные прилагательные
Size: a a a
2019 August 21
D
мы тут не романы пишем
NV
У всех свой уровень навыков. Просто для автора — это очень сложно для доли читателей.
НН
Это наверное был бы пункт номер один в 100 правилах техрайтинга
NV
Ага, _просто_ перепишите документацию в дружелюбном стиле.
I
У всех свой уровень навыков. Просто для автора — это очень сложно для доли читателей.
Ну тут в контексте типа "если очень хочется угореть, то используйте вот такие например странные параметры. Всё будет работать, но пеняй на себя"
А если бы было без simply use я бы наверное воспринял не так. Ну типа было бы более правдоподобно что может какой-то случай будет когда это пригодится
🤔 Хотя ладно, да, пожалуй тут simply можно убрать без потери смысла
А если бы было без simply use я бы наверное воспринял не так. Ну типа было бы более правдоподобно что может какой-то случай будет когда это пригодится
🤔 Хотя ладно, да, пожалуй тут simply можно убрать без потери смысла
НН
Тебе изи сделать болдом текст, а кто-то будет в Ворде 20 минут искать где это сделать
D
лучше разжевать по шагам, чтобы читатль увидел, что это изи
не надо ему рассказывать, что тут нефиг делать
не надо ему рассказывать, что тут нефиг делать
НН
Это как журналистика, в ней нет оценочного суждения
VS
Как без оценочных прилагательных озаглавить два раздела: "простой путь" и "для продвинутых пользователей"?
D
надо писать понятно и доступно
но не надо писать "ну тут просто ваще"
но не надо писать "ну тут просто ваще"
НН
Как без оценочных прилагательных озаглавить два раздела: "простой путь" и "для продвинутых пользователей"?
Newcomers u Advanced
VS
Advanced – разве это не оценочное?
I
Experienced?
НН
Experienced?
Д
YD
вот помнится в школьных учебниках по физике после восьмиэтажной формулы обычно следовала фраза типа "из формулы (х.х) очевидно, что ...." и ничего там не очевидно
VS
Опять же, а если я тот самый продвинутый пользователь, но ищу временный простой фикс?
Я в "newcomers" ожидаю разжеванный до мелочей getting started, и туда я не пойду)
Я в "newcomers" ожидаю разжеванный до мелочей getting started, и туда я не пойду)
НН
Опять же, а если я тот самый продвинутый пользователь, но ищу временный простой фикс?
Я в "newcomers" ожидаю разжеванный до мелочей getting started, и туда я не пойду)
Я в "newcomers" ожидаю разжеванный до мелочей getting started, и туда я не пойду)
а если в ньюкамерс гайде сделать оглавление, то можно легко прыгнуть куда надо к хотфиксу
I
вот помнится в школьных учебниках по физике после восьмиэтажной формулы обычно следовала фраза типа "из формулы (х.х) очевидно, что ...." и ничего там не очевидно
В школьных не помню такого.
А вот институтские когда потом всё-таки разберёшься кайф потом это читать и понимать что всё и правда очевидно ;)
А вот институтские когда потом всё-таки разберёшься кайф потом это читать и понимать что всё и правда очевидно ;)
I
Опять же, а если я тот самый продвинутый пользователь, но ищу временный простой фикс?
Я в "newcomers" ожидаю разжеванный до мелочей getting started, и туда я не пойду)
Я в "newcomers" ожидаю разжеванный до мелочей getting started, и туда я не пойду)
Вот Раскин говорит что делать отдельные интерфейсы "для новичков" и "для продвинутых" — зло, и лучше всем одинаковые сразу. Пожалуй в документации та же история должна быть