Aplikuj Python Developer (Mid/Senior)

Aplikuj Senior Business Analyst

Dlaczego warto tworzyć pliki READ_ME.MD?12 stycznia 2018

Dlaczego warto tworzyć pliki READ_ME.MD?Markdown to język znaczników, pomocny przy tworzeniu i prowadzeniu dokumentacji projektów, który stał się wśród programistów praktycznie standardem w dokumentowaniu kodu. Nieodłącznym elementem projektu wykorzystującego język Markdown jest jego dokument opisowy, który może stać się wizytówką naszego projektu oraz punktem zwrotnym dla jego dalszego jego rozwoju.

Zrób dokumentację projektu dla innych

Samo stworzenie i upublicznienie kodu nie jest równoznaczne z tym, że nagle zaczną z niego korzystać programiści na całym świecie. Bez stworzenia dokumentacji projektu ciężko będzie przyciągnąć do niego ludzi. To właśnie w zamieszczanym najczęściej katalogu głównym projektu pliku READ_ME przedstawić przeznaczenie kodu oraz podać instrukcję jak z niego korzystać. Jeżeli upubliczniasz swój projekt w platformie open source, zapraszając tym samym do uczestnictwa w jego rozwoju innych programistów, to właśnie dzięki informacjom zawartym w pliku READ_ME wskażesz im w jaki sposób mogą rozwijać Twój kod.

Polecane oferty pracy

Zrób dokumentację projektu dla siebie

Z drugiej strony spisanie tego jak działa stworzona przez Ciebie biblioteka, pozwoli na uporządkowanie wiedzy na temat własnego projektu. Usystematyzowanie informacji o własnej pracy może pomóc w dalszym rozwoju projektu, czy ewentualnych poprawkach, do niedociągnięć których wcześniej nie wychwyciliśmy. Ponadto informacje zawarte w pliku READ_ME są świetnym źródłem do przypomnienia sobie szczegółów dotyczących poszczególnych rozwiązań, czy algorytmów w konkretnych części kodu. W wypadku, gdy pracujemy równolegle nad kilkoma projektami i wracamy do porzuconego projektu po pewnym czasie lub kod stał się na tyle rozległy, że nie jesteśmy w stanie zapamiętać wszystkiego dokument opisowy jest niezbędny. Pisanie dokumentacji jest nieodłącznym elementem programowania, którego tak samo jak kodowania musimy się uczyć. Tworzenie kolejnych dokumentacji projektów sprawi, że proces ten będzie dla nas coraz łatwiejszy, a co za tym idzie podniesiemy swoje kwalifikacje zawodowe.

Twoja opinia jest dla Nas Ważna

Oceń ten wpis
Prześlij nam swoje CV

Najnowsze oferty pracy:

Polecane wpisy na blogu:

Kierunek: Holandia. Co programista musi wiedzieć przed decyzją o emigracji?

Body leasing czyli programista na godziny

Jak przeżyć oczekiwanie na wynik rozmowy rekrutacyjnej

Najnowsze komentarze

Moneetor
2018-10-12 00:42:16
http://netpoint.systems
2018-10-10 21:04:58
Marcin Adamski
2018-10-06 20:07:02
Sylwia
2018-09-10 17:25:16
Krzysztof Cierpiał
2018-08-31 16:01:24
TamaraBurska
2018-08-21 17:35:59
Grzegorz Biskup
2018-07-29 15:54:43
luiza
2018-06-29 10:09:04
luiza
2018-06-28 09:48:22
kjonca
2018-06-22 17:41:09
Może zainteresuje Cię również: