Close

Kategorie

Szablon komponentów projektu

autor: Tony Starr, Kierownik ds. projektowania treści @ Atlassian

To narzędzie pozwoli Ci utworzyć bibliotekę dokładnie udokumentowanych komponentów projektu

Użyj szablonu
Szablon komponentów projektu

Monitorowanie wszystkich komponentów, jakich zespół używa w swoich projektach może stanowić nie lada wyzwanie, zwłaszcza gdy zespół się rozrasta. Szablon komponentów projektu pozwoli Ci udokumentować każdy z nich od podstaw, uwzględniając to, co dany komponent robi, jego budowę, a także specyfikę wyglądu i działania w różnych kontekstach. Zawiera on nawet sekcję na dodatkowe wytyczne, w której można objaśnić właściwe dla komponentu reguły treści, dostępności, mobilności itp. W ten sposób możesz utworzyć całą bibliotekę komponentów od zera!

Jak korzystać z szablonu Komponent projektu

Krok 1. Rozpoczęcie od podstaw

Zanim przejdziesz do szczegółowego opisu specyfiki komponentu, musisz przedstawić podstawowe informacje. Rozpocznij od wypełnienia pól w sekcji Podstawowe informacje o komponencie: nadaj komponentowi nazwę, opisz, co robi, oraz zamieść schemat jego budowy wraz z ponumerowanymi objaśnieniami. W oparciu o nie można utworzyć klucz i zdefiniować każdy element budowy komponentu. Ta sekcja ma na celu uświadomienie użytkownikom komponentu, w jaki sposób wszystkie jego elementy współdziałają ze sobą.

Krok 2. Przedstawienie specyfiki

W tym miejscu zaczniesz poznawać różne sposoby wykorzystania komponentu w projektach bardziej rozbudowanych funkcji. Opisz sposób użycia komponentu, uwzględniając jego cel w projekcie jako całości. Następnie omów, jak on wygląda i działa w różnych kontekstach. Do przedstawienia różnych wariantów wykorzystaj aktywny kod z repozytorium swojego systemu projektowania. Na końcu opisz styl wizualny komponentu. Pamiętaj o dodaniu przykładów zaleceń i zakazów.

Krok 3. Udokumentowanie porad, wskazówek i najlepszych praktyk

Każdy komponent ma swoje wady. Zapisz je w sekcji Dodatkowe wskazówki. Zacznij od następujących kwestii: czy istnieją reguły interpunkcji właściwe dla tego komponentu? Co z etykietami standardowymi? Zapisz odpowiedzi, a także wszelkie inne potencjalne problemy z dostępnością właściwe dla komponentu oraz porady dotyczące jego zastosowania w środowiskach mobilnych. Jeśli istnieją najlepsze praktyki dotyczące stosowania komponentu przyjęte jako standard w branży, je również uwzględnij. Na końcu dodaj łącza do wszelkich powiązanych komponentów lub wzorców.

Krok 3. Udokumentowanie porad, wskazówek i najlepszych praktyk
Atlassian

Tony Starr

Kierownik ds. projektowania treści @ Atlassian


Tony jest kierownikiem ds. projektowania treści w Atlassian. Jest on multidyscyplinarnym autorem treści technicznych i kreatywnych, który z pasją wyznacza standardy i wkracza z wytycznymi dotyczącymi tworzenia treści na nowe obszary.

  • Słownik na potrzeby tworzenia treści

    Atlassian

    Słownik na potrzeby tworzenia treści

    Naucz autorów tekstów korzystania z nazw produktów, pojęć branżowych oraz innych elementów treści dzięki przewodnikowi od A do Z.

    Użyj szablonu Dowiedz się więcej
  • Strategia dotycząca treści

    Atlassian

    Strategia dotycząca treści

    Utwórz plan strategii dotyczącej treści i uporządkuj swój kalendarz redakcyjny.

    Użyj szablonu Dowiedz się więcej
  • Raport z rozmowy z klientem

    Atlassian

    Raport z rozmowy z klientem

    Zamień rozmowy z klientem we wnikliwe analizy, korzystając z raportu z rozmowy z klientem.

    Użyj szablonu Dowiedz się więcej