Difference between revisions of "JaWiki:TechRules"

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search
(У каждой страницы должен быть смотритель)
m (Имена wiki должны быть англоязычными: символы в именах)
Line 3: Line 3:
 
Данные правила продиктованы не желанием в чем-то ущемить участников, а вполне адекватными причинами. Которые и указаны в комментарии к правилам.
 
Данные правила продиктованы не желанием в чем-то ущемить участников, а вполне адекватными причинами. Которые и указаны в комментарии к правилам.
  
===Имена wiki должны быть англоязычными===
+
=== Имена статей должны быть англоязычными ===
Имена wiki следует выбирать англоязычные. Например, в случае если хочешь написать правила, то лучше использовать <nowiki>[[Rules]]</nowiki>, а не <nowiki>[[Правила]]</nowiki>.
+
  
Связано это в первую очередь с удобством навигации. Дело в том, что русские буквы нельзя использовать в качестве www-адреса, поэтому используется экранирование символов. Поэтому слово "Правила" будут экранировано и приведены к виду "%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0" что нечитабельно в принципе. Помимо этого, если Mozilla показывает ссылки русскими буквами в строке состояния, то Opera показывает экранированными, что тоже нехорошо. ({{fixme|А как показывают такие ссылки IE и MyIE}})
+
Имена статей следует выбирать англоязычные. Например, в случае если хочешь написать правила, то лучше использовать <tt><nowiki>[[Rules]]</nowiki></tt>, а не <tt><nowiki>[[Правила]]</nowiki></tt>.
  
<strike>Wiki-имена служебных страницы позволительно делать русскими, с обычными страницами лучше избегать этого.</strike> Правило "англиского названия" распространяется и на служебные страницы.
+
Связано это в первую очередь с удобством навигации. Дело в том, что русские буквы нельзя использовать в качестве www-адреса, поэтому используется экранирование символов. Например, слово &laquo;Правила&raquo; будут экранировано и приведены к виду &laquo;%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0&raquo;, что нечитабельно в принципе. Помимо этого, если Mozilla и Opera показывают ссылки русскими буквами в адресной строке, то Internet Explorer показывает экранированными, что тоже нехорошо.
 +
 
 +
То же самое относится ко многим спецсимволам, так что в названиях статей, кроме литинских букв (строчные и заглавные различаются, первая всегда залавная) рекомендуется ограничиться символами
 +
{|
 +
| &laquo;/&raquo; (косая черта)
 +
| &laquo;&nbsp;&raquo; (пробел)
 +
| &laquo;_&raquo; (знак подчёркивания)
 +
| &laquo;:&raquo; (двоеточие)
 +
|-
 +
| &laquo;.&raquo; (точка)
 +
| &laquo;*&raquo; (звёздочка)
 +
| &laquo;&amp;&raquo; (амперсанд)
 +
| &laquo;^&raquo; (крышка)
 +
|-
 +
| &laquo;$&raquo; (знак доллара)
 +
| &laquo;!&raquo; (восклицательный знак)
 +
| &laquo;(&raquo; и &laquo;)&raquo; (открывающая и закрывающая круглые скобки)
 +
| &laquo;;&raquo; (точка с запятой)
 +
|-
 +
| &laquo;'&raquo; (апостроф)
 +
| &laquo;-&raquo; (дефис)
 +
| &laquo;=&raquo; (знак равенства)
 +
| &laquo;~&raquo; (тильда)
 +
|}
 +
 
 +
Правило &laquo;английского названия&raquo; распространяется и на служебные страницы.
  
 
===Страницы должны быть категоризированы===
 
===Страницы должны быть категоризированы===

Revision as of 14:58, 29 May 2007

Правила JaWiki

Данные правила продиктованы не желанием в чем-то ущемить участников, а вполне адекватными причинами. Которые и указаны в комментарии к правилам.

Имена статей должны быть англоязычными

Имена статей следует выбирать англоязычные. Например, в случае если хочешь написать правила, то лучше использовать [[Rules]], а не [[Правила]].

Связано это в первую очередь с удобством навигации. Дело в том, что русские буквы нельзя использовать в качестве www-адреса, поэтому используется экранирование символов. Например, слово «Правила» будут экранировано и приведены к виду «%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0», что нечитабельно в принципе. Помимо этого, если Mozilla и Opera показывают ссылки русскими буквами в адресной строке, то Internet Explorer показывает экранированными, что тоже нехорошо.

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

«/» (косая черта) « » (пробел) «_» (знак подчёркивания) «:» (двоеточие)
«.» (точка) «*» (звёздочка) «&» (амперсанд) «^» (крышка)
«$» (знак доллара) «!» (восклицательный знак) «(» и «)» (открывающая и закрывающая круглые скобки) «;» (точка с запятой)
«'» (апостроф) «-» (дефис) «=» (знак равенства) «~» (тильда)

Правило «английского названия» распространяется и на служебные страницы.

Страницы должны быть категоризированы

Следует все материалы разделять на категории. Чтобы отнести материал к категории (можно больше чем одной), следует добавить [[Category:CategoryName]], где CategoryName -- название категории, к которой относится статья, на английском языке. Одна статья може относится к разным категориям.

В случае, если категория, нужная Вам еще не создана -- не проблема, она создасться автоматически.

Разделение по категориям упрощает навигацию и структурирует материал.

Изменения должны иметь описание

Вносимые изменения должны иметь описание (поле "Краткое описание" ниже основного поля редактирования). Исправление ошибок -- bugfix, исправление опечаток -- typo. В случае малозначимых исправлений, желательно поставить флажок "Это - малозначимое изменение". Связано это с удобством чтения журнала изменений

Комментарии должны быть подписаны

При добавлении комментария, подписывайтесь. Это не сложно: добавьте пустую строку и --~~~~ в конце комментария. Или просто нажмите соответствущую кнопку (вторая справа, 'Your signature with timestamp') на панели инструментов редактирования.

Наличие подписей к комментариям упрощает их идентификацию. В любом случае, автор комментария будет отмечен в истории правок.

У каждой страницы должен быть смотритель

Для тех статей, автором или соавтором которых вы являетесь включайте функцию наблюдения. При этом ваш JID должен быть подтвержден в вашем Wiki-аккаунте! Изначально все адреса являются неподтвержденными. Для подтверждения адреса перейдите на страницу настроек и щелкните по ссылке "Подтвердить JID". Перейдите по полученной после этого ссылке. Теперь при изменении страниц, которые находятся в вашем списке наблюдения вы будете получать уведомление. Старайтесь их просматривать и откатывать те изменения, которые являются явно вандальными или ошибочными.

Для автоматического включения в список наблюдения страниц, которые вы создадите или отредактируете, воспользуйтесь соответствующими флажками в вашем профиле. "Add pages I create to my watchlist" и "Add pages I edit to my watchlist" на закладке "Editing".

Спорные или субъективные правки

В случае спорной правки от зарегистрированного автора желательно решать все полюбовно и обсуждать сложившуюся ситуацию. При необходимости отката правки стараться обосновывать это действие.

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



Данный свод правил был впервые было опубликовано по адресу http://wiki.omsktele.com/index.php/OTCwiki:Rules Их автор J2A.