Poszukiwani superbohaterowie: Jak łatwo ulepszyć TYPO3
Zespół ds. dokumentacji TYPO3 pilnie poszukuje wsparcia ze strony społeczności. Każdy - od początkujących po profesjonalistów - może wnieść cenny wkład, a dobra dokumentacja ma kluczowe znaczenie dla sukcesu oprogramowania open source.
Zespół Dokumentacji TYPO3 poszukuje obecnie "superbohaterów" do swojej dokumentacji. Jako ktoś, kto pracuje z TYPO3 prawie codziennie od 2006 roku, mogę tylko powiedzieć: To cholernie ważna sprawa.
Dlaczego? Ponieważ słaba dokumentacja jest jednym z powodów, dla których wiele osób odrzuca TYPO3 jako "zbyt skomplikowany". Problemem często nie jest system, ale fakt, że informacje są trudne do znalezienia lub nieaktualne.
Zespół złożony z Liny Wolf, Sarah McCarthy i Garvina Hickinga jest tego świadomy. Oni to wiedzą: Dobra dokumentacja robi różnicę między frustracją a sukcesem w nowych projektach TYPO3.
Wspaniała rzecz: nie musisz być profesjonalistą od dokumentacji. Nawet niewielki wkład może pomóc. Poprawienie literówki, ulepszenie niejasnego przykładu kodu lub przepisanie mylącego wyjaśnienia - wszystko to jest cenne.
Łatwo jest zacząć: na każdej stronie dokumentacji znajduje się przycisk "Edytuj na GitHub". Kliknij go, wprowadź zmiany i gotowe. Zespół sprawdza wszystko przed opublikowaniem. Nie możesz niczego zepsuć.
Obecnie pali się pod paznokciami:
- Instrukcje tworzenia rozszerzeń
- Uruchamianie TYPO3 za pomocą Dockera
- Wyjaśnienie trybu klasycznego i trybu kompozytora
- Dopracowanie referencji ViewHelper
Szukają doświadczonych osób związanych z Fluidem, zwłaszcza ViewHelperów. Jeśli regularnie tworzysz szablony Fluid, będzie to Twoja szansa, aby pomóc innym i jednocześnie dać coś od siebie.
Co miesiąc odbywają się spotkania na kanale Slack #typo3-documentation. Plus sesje na żywo, do których można dołączyć bezpośrednio.
Kompletny przewodnik można znaleźć pod adresem "Jak dokumentować TYPO3". Oryginalny artykuł zawiera wszystkie szczegóły.
Myślę, że to wspaniałe, jak TYPO3 działa jako społeczność. Każdy może wnieść swój wkład, każdy jest potrzebny.
Czy kiedykolwiek współtworzyłeś dokumentację open source? A może pomysł współtworzenia TYPO3 przemawia do Ciebie?
Back
Kto tu pisze?
Cześć, jestem Wolfgang.
Od 2006 roku zagłębiam się w fascynujący świat TYPO3 - to nie tylko mój zawód, ale także moja pasja. Moja ścieżka prowadziła mnie przez niezliczone projekty i stworzyłem setki profesjonalnych samouczków wideo skupiających się na TYPO3 i jego rozszerzeniach. Uwielbiam rozwikływać złożone tematy i przekształcać je w łatwe do zrozumienia koncepcje, co znajduje również odzwierciedlenie w moich szkoleniach i seminariach.
Jako aktywny członek Komitetu Edukacyjnego TYPO3, jestem zaangażowany w utrzymywanie aktualnych i wymagających pytań egzaminacyjnych TYPO3 CMS Certified Integrator. Od stycznia 2024 roku mam zaszczyt być oficjalnym Partnerem Konsultacyjnym TYPO3!
Ale moja pasja nie kończy się na ekranie. Kiedy nie nurkuję w głębinach TYPO3, często można mnie spotkać na rowerze, eksplorującego malownicze szlaki wokół Jeziora Bodeńskiego. Te wycieczki na świeżym powietrzu są dla mnie idealną równowagą - utrzymują mój umysł w świeżości i zawsze dostarczają mi nowych pomysłów.