MDC:Ujednoznacznienie

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Spis treści 1 Wprowadzenie 2 Kiedy tworzymy strony ujednoznaczniające? 3 Jak tworzymy strony ujednoznaczniające? 4 Co zawiera strona ujednoznaczniająca? 4.1 Krótkie wprowadzenie 4.2 Szablon ujednoznaczniający 4.3 Lista stron niejednoznacznych 5 Najlepsze zastosowania 6 Fixing links to disambiguated topics 7 Jeśli potrzebujesz pomocy lub chcesz o coś zapytać 8 Więcej informacji

[edytuj] Wprowadzenie

Strony ujednoznaczniające (ang. disambiguation pages) to strony MDC, zawierające linki (odnośniki) do stron precyzujących poszczególne znaczenia danego hasła (i tylko takie linki).

Ponieważ są to zupełnie różne rzeczy, informacje o nich powinny się znaleźć w (liczbie) różnych artykułach. Jednak autorzy artykułów mogą być nieświadomi tego, że istnieje jakiś "inny" artykuł (teoretycznie o dwóch takich samych tytułach), lub po prostu nie wiedzieć, pod jakim tytułem znajduje się drugi artykuł, dlatego stworzono strony ujednoznaczniające. Na przykład: indexOf jest metodą dla obu metod obiektów String i Array w JavaScripcie.

Podobnie do Wikipedii rozróżniamy strony za pomocą kwalifikatorów umieszczonych w nawiasach po tytule (tj: "Mercury (planet)"). Jednakże użytkownicy poszukujący informacji dotyczących "indexOf" natrafi najprawdopodobniej na Devmo i wpisze "indexOf" w pole wyszukiwania. Wynik wyszukiwania powyższej frazy będzie po części niepożądany, gdyż pokaże tytuły, artykuły, odnośniki w wiki, przykładowe kody. W celu wspomożenia użytkownika, by łatwiej znalazł poszukiwana rzecz rozpoczęliśmy dodawać do wiki strony ujednoznaczniające.

[edytuj] Kiedy tworzymy strony ujednoznaczniające?

Strony ujednoznaczniające należy tworzyć tylko w celu wyjaśnienia niejasności powstałych pomiędzy dwoma lub większa ilością stron.

[edytuj] Jak tworzymy strony ujednoznaczniające?

Strony ujednoznaczniające są tworzone ręcznie przez naszych edytorów, aby powiązać wszystkie strony jakie mogą interesować czytelnika poszukującego niejednoznacznego terminu. Pozwalają czytelnikowi na szybkie przejrzenie listy niejednoznacznych stron i wybranie poszukiwanej.

Aby stworzyć stronę ujednoznaczniającą stwórz stronę, której tytułem jest niejednoznaczny termin, np. indexOf.

[edytuj] Co zawiera strona ujednoznaczniająca?

Tworząc stronę ujednoznaczniającą potrzebujesz dwóch rzeczy:

[edytuj] Krótkie wprowadzenie

Dodaj krótkie wprowadzenie na górze strony, tj. "indexOf jest metodą różnych obiektów JavaScriptu:", "indexOf jest używany na kilka sposobów:", lub po prostu "indexOf może mieć następujące znaczenia:".

[edytuj] Szablon ujednoznaczniający

Dodaj szablon disambig na górze strony. Szablon wklei standardową notkę i przypisze kategorie stron ujednoznaczniających.

[edytuj] Lista stron niejednoznacznych

Then simply add a linked list of the ambiguous page titles, with a short summary for each. I'll refer you to the indexOf disambiguation page for examples.

If a list of linked titles and summaries becomes unweildy, you are welcome to organize the list by dividing it up into logical sections or groupings.

[edytuj] Najlepsze zastosowania

1. Strony ujednoznaczniające powinny kierować wyłącznie do stron aktualnie istniejących w wiki.
2. Do not link to other pages in the summaries in a disambiguation page. For example, do not do this: "indexOf - method for the String object in JavaScript". Just leave it as "indexOf - method for the String object in JavaScript". Extraneous links serve no purpose on a disambiguation page.
3. Shorten the link title, if necessary, to the term being disambiguated. Rather than linking to Dokumentacja języka JavaScript 1.5:Obiekty:String:indexOf, use the alt-text facility to shorten it to indexOf.
4. Disambiguation pages are not intended for games of "free association". Please use them carefully and only when needed.

[edytuj] Fixing links to disambiguated topics

After you create a disambiguation page, click the "What links here" link to see if any existing page link to your new disambiguation page. If there are pages linking directly to the disambiguation page, please go to those pages and change the links, where possible, so they point at the correct page within the wiki.

For example, if a page talking about the JavaScript String object's indexOf method links to the indexOf disambiguation page, that link should be changed so it points directly at the Dokumentacja języka JavaScript 1.5:Obiekty:String:indexOf page.

If you are creating a disambiguation page that will involve moving an existing page, click, click on "What links here" to find all the pages that link to the page you are about to move. Make sure those pages are fixed or that they won't be adversely affected before you do the move.

A code of honor for creating disambiguation pages is to fix all of the links involved.

[edytuj] Jeśli potrzebujesz pomocy lub chcesz o coś zapytać

Jeśli nie jesteś pewny jak nazwać lub ujednoznacznić stronę, napisz maila do Deb Richardson albo zapytaj na liście mailingowej devmo-general.

Możesz także skorzystać z kanału IRC #devmo na serwerze irc.mozilla.org.

[edytuj] Więcej informacji

Strony ujednoznaczniające outlines their policies and approaches. Note that our policies do not match precisely.