Pl:Wskazówki dotyczące Wiki

From OpenStreetMap Wiki
(Redirected from Pl:Wiki guidelines)
Jump to navigation Jump to search
Wstęp Wskazówki Struktura Tłumaczenie Porządkowanie Pomoc

Podczas pisania stron Wiki należy przestrzegać "Wytycznych Wiki". Pomoże to stworzyć użyteczną i łatwą w użyciu Wiki, która będzie dostępna dla wszystkich. WikiProject Cleanup to strona koordynująca prace nad Wiki w celu zwiększenia zgodności z tymi wytycznymi.

Zrozumiałość

Twórz krótkie strony, używaj prostego języka i unikaj żargonu. OpenStreetMap ma być dostępny dla wszystkich, a nasza dokumentacja powinna to odzwierciedlać. Celuj swoim pismem aby tekst był zrozumiały na poziomie dzieci i babć!

Niektóre strony Wiki, naturalnie, mają formę dokumentacji technicznej. Nawet w nich powinniśmy dążyć do tego, by były zrozumiałe dla użytkowników posiadających szereg technicznych umiejętności. Pisz proste wprowadzenia do tematu i rozważ rozdzielenie bardzo skomplikowanych szczegółów, aby oddzielić bardziej ważne strony Wiki.

Struktura

Wiki powinno być tak skonstruowane, aby umożliwić ludziom łatwe znajdowanie treści, których szukają, począwszy od Main Page. Niektóre kluczowe treści są bezpośrednio powiązane ze Stroną Główną, ale inne linki do stron głównych prowadzą do "stron początkowych" konkretnego tematu.
Są one kolejnym poziomem w jakiejś hierarchii nawigacji. Często są to krótkie strony z wieloma linkami i niezbyt dużym tekstem (znane również jako "portale"). Potrzebna jest dodatkowa praca, aby zapewnić, że ta nawigacja nadal działa skutecznie dla nowych użytkowników.

Sprzeczne informacje

Sprzeczne informacje są bardzo złe. Informacje na temat bieżących zaleceń dotyczących tagowania powinny być spójne. Jeśli tak nie jest, prosimy skontaktować się z innymi użytkownikami w celu osiągnięcia konsensusu. Zalecenia dotyczące tagowania powinny idealnie pasować do rzeczywistego tagowania, chyba że istnieje uzasadniony powód, aby tego nie robić.

Propozycje i proponowane zmiany w tagowaniu są wyjątkiem od tej reguły. Należy je jednak wyraźnie zidentyfikować jako propozycje.

Powielanie

Powielanie jest często złe, ponieważ grozi dostarczeniem sprzecznych informacji i zwiększa ilość pracy. W przypadku niepotrzebnego powielania, należy zracjonalizować je, aby zapewnić jedno jasne źródło informacji. Na przykład treść z Wikipedii, można zastąpić linkiem do niej (weryfikowalność treści).
Może to wymagać przedyskutowania z innymi użytkownikami! Można podsumować temat na innej stronie, ale podsumowanie musi zawierać link do strony głównej.

Template:merge służy do oznaczania stron wymagających reorganizacji w celu usunięcia duplikatów, z podobną zawartością, stron.

W przypadku, gdy powielanie jest przydatne (na przykład jest prezentowane w innym stylu, strukturze strony lub dla różnych odbiorców), ważne jest, aby wyjaśnić powody takiego stanu rzeczy i połączyć je, aby uniknąć nieporozumień. Jeśli nie ma powodu do powielania, strony powinny zostać scalone. Pamiętaj, że scalenie niekoniecznie oznacza, że pozostaje nam jedna strona, na której były dwa wcześniej. Istnieją inne wyniki, na przykład nietechniczna strona z podsumowaniem strony może zawierać link do bardziej szczegółowej strony technicznej.

Tytuły - Konwencja nazewnictwa stron

Proszę śledzić konwencję nazewnictwa w Wikipedii (kapitalizacja):
W przypadku tytułów stron wielowierszowych należy napisać drugie i kolejne słowa małymi literami, chyba że fraza tytułu jest właściwym rzeczownikiem, które zawsze występowałoby w postaci wielkimi literami, nawet w środku zdania.

Nie używaj "CamelCasePageTitles", w których słowa są połączone bez spacji - MediaWiki pozwala nam używać spacji jak w naturalnym języku. Wyjątkiem byłaby sytuacja, w której tytuł strony jest nazwą czegoś, co "zazwyczaj" ma połączone słowa, np. "OpenLayers"

Prefiksy w tytułach stron były używane w przeszłości (np. prefiks 'WikiProject'). Jest to w większości uciążliwa spuścizna, ale nie można tego łatwo naprawić na tym etapie. Przeniesienie wszystkich takich stron byłoby bardzo dużym zadaniem. Jednak odradza się tworzenie schematów prefiksów tytułów stron. Użyj tytułów stron w języku naturalnym i połącz zestaw stron, aby utworzyć struktury linków w treści samych stron, na przykład Zamki w Krakowie. Proszę odwołać się do struktury Wiki dla aktualnej dyskusji na ten temat.

Wprowadzenie

Strony powinny zaczynać się od krótkiego akapitu wprowadzającego zawierającego kilka zdań w kontekście OSM. Powinno to zawierać nazwę znacznika, lub tytuł, "pogrubione" i wyjaśnić, o czym jest strona/znacznik. Często przydatne jest dołączenie linku do bardziej ogólnej strony i do bardziej szczegółowych stron, ponieważ pomaga to w nawigacji.

Ta wstępna sekcja powinna pojawić się przed jakimkolwiek nagłówkiem (i przed Spisem treści na długiej stronie). Zwróć uwagę, że dość często ludzie tworzą pierwszy nagłówek "Wprowadzenie". To powinno zostać zrestrukturyzowane, aby przynajmniej część wprowadzenia znajdowała się u góry strony nad jakimkolwiek nagłówkiem. Zapewni to spójny układ na Wiki.
Na przykład: Pl:Tag:landuse=forest

Linki

Strony powinny być dobrze połączone, aby pomóc użytkownikom znaleźć informacje, których szukają. Ważne powiązane pojęcia są zazwyczaj związane z wprowadzeniem. Jeśli nie możesz wymyślić powiązanej strony wiki, z którą można się połączyć, prawdopodobnie nie tworzysz strony w wystarczająco szerokich kategoriach. Zachęcamy również do łączenia z pokrewnymi pojęciami w dalszej części strony.

Łączenie sekcji z główną stroną

Kod {{main|nazwa strony}} może być użyty pod nagłówkiem sekcji, aby podać link do strony głównej odnoszącej się do tematu sekcji. Sekcja powinna wtedy jedynie podsumować linkowaną stronę główną (i z pewnością nie powinna, w żaden sposób, być z nią sprzeczna). Tytuł sekcji powinien zwykle być taki sam jak strona, z którą jest połączony.

Linkowanie do Wikipedii

Linki do Wikipedii mogą być mylące. Tylko link do Wikipedii, wtedy jest przydatny, jeśli pojęcie nie jest lepiej wyjaśnione w kontekście OSM na tej wiki.

Jeśli używasz składni [[wikipedia:nazwa strony]] interwiki, zostaw prefiks 'wikipedia:' na swoim miejscu, tj. nie używaj alternatywnego linku: [[wikipedia:nazwa strony|nazwa strony]] ponieważ jest to bardzo mylące w podstawowym znaczeniu nawigacyjnym. Możesz jednak użyć szablonu, aby zewnętrzny link do Wikipedii był bardziej wyraźny:{{Wikipedia|pl|nazwa strony}}, lub {{Wikipedia|pl|nazwa strony|text= no }} zachowaj ikonę wiodącą bez końcowego tekstu "na Wikipedii".

Nie twórz linków do stron Wikipedii, na których istnieje ten sam lub podobny tytuł na tej wiki (z wyjątkiem artykułu na tej wiki, gdzie można go użyć jako dodatkowego odnośnika zewnętrznego, aby uzyskać więcej informacji na ten temat).

Strona o stronie internetowej

Mamy wiele stron Wiki poświęconych opisowi zewnętrznej strony internetowej (usługi map, oprogramowanie itp.). Oczywiście zewnętrzny link do tej strony jest niezwykle ważny. Główny odnośnik powinien być umieszczony w nawiasach po tytule (który jest pogrubiony) w pierwszym zdaniu i/lub połączony większym tekstem w jego linii po najwyższych opisowych zdaniach.

Na tych stronach nie ma sensu powielanie za dużo 'o' informacji znalezionych na stronie zewnętrznej. Strona powinna opisywać witrynę w kontekście OSM. Bądź bardziej neutralny i mniej promocyjny z twoim opisem, chociaż staraj się używać języka, który promuje OSM i używa OSM.

Lista oprogramowania/usług

Mamy wiele stron zawierających listy punktowane lub tablice Wiki () zawierające wykaz oprogramowania/usług. Jeśli mamy strony wiki o oprogramowaniu, a nawet jeśli nie mamy (czerwone linki), preferowanym formatem jest wewnętrzny link do strony wiki OSM, a następnie zewnętrzny link do strony w nawiasach. Następnie może pojawić się krótki opis lub inne kolumny tabeli. Powinniśmy dążyć do zapewnienia linków zarówno do strony wiki, jak i do linku zewnętrznego, nawet jeśli strona wiki jeszcze nie istnieje, aby zachęcić do zdrowego poziomu powiązań wiki. Czerwone linki można wypełniać informacją pośrednią zgodnie z powyższymi wskazówkami.

Pełne linki zewnętrzne URL mogą być miłe, jeśli są krótkie, ponieważ użytkownik wie, czego się spodziewać po kliknięciu. Należy użyć alternatywnego tekstu linku, aby to skrócić, najlepiej do nazwy domeny, aby było jasne, że jest to link zewnętrzny.

Przykład:

W bardzo ograniczonych przestrzeniach (często w przypadku tabel Wiki) możemy użyć składni z numerowanymi linkami (np. [1]), aby zmniejszyć zewnętrzny link w dół. Możemy zrezygnować z linku zewnętrznego i połączyć tylko do strony Wiki, ponieważ będzie ona miała link zewnętrzny. Jeśli strona wiki nie istnieje, możemy wybrać tylko zewnętrzny link, ale lepiej byłoby utworzyć stronę Wiki z krótkim opisem.

Kategorie

Do grupowania stron według rodzaju należy używać kategorii, które powinny być zgodne z tymi samymi konwencjami nazewnictwa, co w przypadku stron wiki.

Kategorie mogą być kategoryzowane w celu utworzenia hierarchii, która pomoże przenieść nas do interesującego nas tematu. Na przykład Category:Pl:Budynki znajduje się w kategorii Category:Pl:Infrastruktura.

Strony mogą należeć do wielu kategorii, ale nie powinny zawierać kategorii 'spam'. Strona odnosząca się do autobusów (na przykład strona o przystankach autobusowych) powinna być zakwalifikowana jako 'Buses', ale nie jako 'Public transport'. Jednak główna strona Buses powinna być oznaczona w granicach kategorii Category:Public transport, a także bardziej specyficznie.

Dla każdej kategorii powinna być jedna linijka wprowadzenia, która powinna ogólnie zawierać link do odpowiedniej 'głównej' strony dla obiektu, najlepiej o tej samej nazwie. Na przykład Strony dotyczące [[Public transport]] jako wprowadzenie do kategorii 'Public transport'.

Podczas kategoryzacji, strony powinny w razie potrzeby korzystać z opcji sortowania, aby upewnić się, że są odpowiednio wyświetlane na liście stron. Dla przykładu spójrz na strony wymienione w Category:Users in London. Będą one wszystkie wymienione pod 'U' z powodu prefiksu 'User:', ale może to być zmienione. Na przykład User:Harry Wood ma kategorię tekstu Wiki: [[Category:Users in London|Harry Wood]] z frazą sortującą dostarczoną po |.

Język

OpenStreetMap korzysta z brytyjskiego angielskiego dla ogólnych stron angielskich i odpowiedniego 'lokalnego' języka angielskiego dla zlokalizowanych stron tematycznych. Tak więc każda strona, która w większości dotyczy Stanów Zjednoczonych, z jakiegokolwiek powodu używałaby amerykańskiego angielskiego. Dotyczy to szczególnie stron miejsc w Mapping projects.

Tłumaczenie

Zobacz Wiki Translation. Obejmuje ona wstępne filozoficzne przemyślenia na temat tego, co chcemy osiągnąć dzięki tłumaczeniom na Wiki, podczas gdy nie jest jasne, czy Wiki będzie migrować do rozszerzenia tłumaczeń.

Formatowanie daty

Daty powinny być sformatowane w jeden z poniższych sposobów w zależności od wymaganej precyzji:

  • 1 August 2009 (normalny format, chyba że jest niepewność lub gdy dzień jest bardzo istotny; nie ma potrzeby dodawania początkowego zera w wartości dnia)
  • Wednesday 1 August 2009 (kiedy dzień tygodnia ma znaczenie)
  • August 2009 (dzień miesiąca nie jest znany ani odpowiedni)
  • 2009-08-01 (stały format zgodny ze standardem ISO 8601, który ma być wykorzystywany w danych tabelarycznych, zwłaszcza gdy treść powinna zostać włączona na wiele przetłumaczonych stronach, zawiera zero lewego paddingu)
  • 2009-08 (podobne, gdy dzień miesiąca nie jest znany, ani nie ma znaczenia)
  • 2009 (tylko rok, bez separatora grup tysięcy)
  • 'Wkrótce' (August 2009) (kiedy prognoza została dokonana w określonym czasie)

Sufiksy porządkowe (th, nd, rd) nie są konieczne, a dni i miesiące powinny być wypisane w całości. Unikaj niepełnych dat, które są niejasne i unikaj wykorzystania sezonów (lato na półkuli północnej to zima na południe!).

Edycja opisów

Pamiętaj o użyciu pola "Opis zmian" podczas edycji, aby wskazać, co zostało zmienione. Pomaga innym redaktorom.