Readme na github-co umieścic

0

Hej, chciałem wysłać swój kod do oceny do firmy, w której chciałbym pracować i teraz mam takie pytanie wrzuciłem kod na github-a i teraz nie wiem co powinienem umieścić w pliku Readme, jakiś opis jak aplikacja działa? Kiedy ją robiłem ?

Z góry dzięki za wszelkie sugestie!

5
  1. Krótki opis aplikacji - co to? po co?
  2. Opcjonalnie jakieś screeny
  3. Opis instalacji / uruchomienia / zależności
  4. Jak wystawia jakieś API to jego opis + przykłady kodu

Użyj markdownu -> https://help.github.com/articles/basic-writing-and-formatting-syntax/

1

Bardziej dla bibliotek, niż dla programów widocznych dla rekruterów, ale może się przydać: http://rowanmanning.com/posts/writing-a-friendly-readme/

0

Do tego co napisał @Maciej Cąderek dodaj jeszcze informacje o licencji (jeżeli takową repozytorium ma). Jeżeli jest to API, albo jakaś pomniejsza biblioteka, to warto też przedstawić przykład jej zastosowania.

1 użytkowników online, w tym zalogowanych: 0, gości: 1