Правила оформления статей
Код писать на отдельной строке (за исключением случаев, когда код является частью абзаца. Пример:
Дав команду `cat $dfg > asd`
мы получим… В таком случае выделяем код с обоих сторон знаками ''
).
Пути в файловой системе тоже выделять при помощи '' – просто такой шрифт более читабелен, когда, например, нужно отличить символы 1
, I
, l
, O
, 0
…
Всякие «ворнинги» и «типы» – ну это же понятно – статьи же в основном переводные. А если нет, то как заблагорассудится Автору.
Несколько строчек однотипной информации выделять маркированным списком (*), а нумерованный список (-) использовать только при перечислении какой-либо последовательности.
Про грамотность и правила русского языка думаю и так понятно.
Некоторые правила оформления русскоязычных текстов
Точка, запятая, двоеточие, многоточие, точка с запятой пишутся слитно с предшествующим текстом.
Кавычки, скобки пишутся слитно с текстом, который они окружают.
Дефис (-) используется в составных словах (пример: жёлто-красный) и при переносе слов по слогам.
Среднее тире (–) используется между числами (пример: 1943–1945 гг.). Система заменяет два дефиса (--
) на среднее тире.
Длинное (оно же обычное) тире используется во всех остальных случаях (пример: Он для меня — это всё). При этом слева и справа тире отделяется пробелом от окружающего текста. Система заменяет три дефиса (---
) на тире.
Тире в начале строки применяется только в диалогах.
В конце заголовка не ставится точка.
(продолжение следует)