New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Опубликуйте полный дотошный гайд по написанию статей #85

Open
safinaskar opened this Issue Feb 22, 2017 · 0 comments

Comments

Projects
None yet
1 participant
@safinaskar

safinaskar commented Feb 22, 2017

Как я уже писал в соседнем баг репорте ( #80 ), я хочу, чтобы автор поста гарантированно получал уведомление о внесении модератором изменения в его статью.

Кроме этого, в этом баг репорте хочу внести ещё одно предложение: Хабр должен опубликовать дотошный, детальный гайд по написанию статей. Такой, чтобы статья, написанная в соответствии с этим гайдом, гарантированно не подвергалась правкам модераторов. И чтобы таким образом проблемы, обозначенные в соседнем баг репорте, не возникали вовсе.

У вас же модераторы следуют некоей внутренней инструкции? Вот её и опубликуйте. Когда у вас новый модератор приходит на работу, вы же даёте ему некую инструкцию? Опубликуйте её.

Мне не нравится текущая ситуация, мол, "вы, авторы, уж там напишите как-нибудь, а мы, модераторы, уж сами поправим по своему гайду, который мы вам не покажем".

Недавно я опубликовал статью про UNIX: https://habrahabr.ru/post/321652/ . Модераторы её подправили, после чего со мной связались и сообщили об этом. Что ж, хорошо, что сообщили, спасибо. Я буду приводить примеры исправлений из этой статьи дальше в этом баг репорте.

Теперь по пунктам.

Абзацы. Существующие гайды Хабра не рекомендуют слишком большие абзацы. "Слишком большие" - это сколько? Укажите максимальный допустимый размер абзаца (в словах, в знаках) так, чтобы абзацы не больше этого размера гарантированно не разбивались модераторами

Отступы. Отступы перед и после списков, блоков source и blockquote. Как ставить переносы строк вокруг тегов ol, ul, li, source, blockquote, чтобы результат получался красивым? Нет, не надо говорить, мол, откройте предпросмотр, посмотрите на глаз, исправьте, снова откройте предпросмотр и т. д. Мой глазомер может не совпасть с глазомером модератора. Мне может показаться, что нормально, а ему - нет. Вы дайте точные правила постановки whitespace в исходном коде вокруг этих тегов, чтобы результат был гарантированно красивым. Как для html разметки, так и для markdown.

Вот например, методом тыка я выяснил, что блок source выглядит красиво, если перед открывающим тегом оставить пустую строку, а после закрывающего начать текст сразу со следующей строки. Т. е. вот так:

Text

<source>
void f (void);
</source>
Text

Если вы тоже считаете такой вариант оптимальным, включите в гайд. То же для blockquote, ul, ol, img и т. д. У меня в статье был большой ненумерованный список, с пунктами по нескольку абзацев. Модераторы исправили пункты этого списка с такого варианта:

<li>Text</li>
<li>Text</li>

на такой:

<li>Text

</li>
<li>Text

</li>

В исходном коде результат выглядит ужасно. Но если в таких случаях действительно так и надо делать, то внесите это в гайд.

Смайлы и прочее. Мне исправили вот это:

И в ней эта функция называется create. :) Он смог. :)

на это:

И в ней эта функция называется create :) Он смог :)

По какому правилу? Какими правилами русского языка вы руководствуютесь? Какими правилами типографии? Приведите все правила, которыми руководствуютесь. Можно ссылками. То же относится к исправлению целых предложений в скобах с (Это предложение.) на (Это предложение).. К постановке знаков препинания в конце пунктов списков.

Хабракат. Дальше какой линии его нельзя ставить? В строчках, в абзацах, как угодно.

Существующие гайды. Я вижу как минимум два похожих гайда: https://habrahabr.ru/info/madskillz/ и https://habrahabr.ru/company/tm/blog/262653/ . Как так вышло? Один из них - новая версия другого? Тогда укажите в старой версии, что это - старая версия, и что новую нужно искать там-то. Или они оба актуальны? Ну тогда слейте их в один.

Ну а что касается замечаний, высказанных мной в этом баг репорте, то добавьте их в эти существующие гайды либо выделите в отдельный.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment