[Fedora-documentation] Рекомендации по оформлению статей

Степан Федосеев
Пн Янв 31 18:31:25 MSK 2011


Вот, думаю самое основное. :)

По тексту выделять курсивом имена собственные, назмания програм, а также  
различные примечания, параметры и значения: ''Gnome'', ''Nautilus'',  
''--all'', ''Уровень 1'' и т.д.
Клавиши и их сочетания указывать в <угловых скобках> и выделять курсивом:  
''<Esc>'', ''<Alt>+<F2>'' и т.д.
Команды и их вывод указывать в тегах <pre></pre>, либо просто начинать  
строку с пробела: <pre>ls -la | grep -i "Ви"</pre>
Пути к файлам, команды по тексту и маленькие куски кода помещать между  
<code></code>: <code>/etc/yum.repos.d/</code>, <code>su -c "cat >  
привет_мир"</code> и т.д.
При указании последовательности меню, использовать форму: ''Приложения ->  
Мультимедия -> Мой самый любимый плеер''
При конце статьи желательно указывать список источников(если это копипаст).
Так же крайне не желательно использование жаргонизмов и сленга в тексте  
статьи. К примеру "видюха" вместо "видеокарты", "юрез" вместо  
"пользователя" и т.д.


Подробная информация о списке рассылки Fedora-documentation