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.

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:

Big Data w rekrutacji IT– analiza zamiast intuicji

8 kroków do zwiększenia produktywności w pracy

Zrozumieć kobietę czyli jak przyciągnąć i zatrzymać w firmie specjalistki IT

Przeprowadzka za pracą? Czemu nie?

Wakacyjne staże i praktyki – co warto wziąć pod uwagę przy ich organizacji

Najnowsze komentarze

Marta Zabłocka
2018-01-19 22:02:33
Przemek Pełszyński
2018-01-18 18:27:48
Katarzyna Dynek
2017-12-01 13:46:11
Marek Dzimra
2017-11-02 13:50:29
Mirosław
2017-10-20 13:39:50
Madziak56
2017-10-01 19:55:25
Marek Dzimra
2017-09-05 09:38:05
Marek Dzimra
2017-08-03 15:17:36
muuu
2017-06-26 13:44:39
muuu
2017-06-26 13:32:22
Może zainteresuje Cię również:
1 Szukasz specjalistów IT?
Oddzwonimy do Ciebie!