{"id":93089,"date":"2020-09-03T01:42:16","date_gmt":"2020-09-02T23:42:16","guid":{"rendered":"https:\/\/prohoster.info\/blog\/administrirovanie\/awesome-list-svoimi-rukami-ili-github-vmesto-bloknota"},"modified":"2020-09-03T01:42:16","modified_gmt":"2020-09-02T23:42:16","slug":"awesome-list-svoimi-rukami-ili-github-vmesto-bloknota","status":"publish","type":"post","link":"https:\/\/prohoster.info\/pl\/blog\/administrirovanie\/awesome-list-svoimi-rukami-ili-github-vmesto-bloknota","title":{"rendered":"Zr\u00f3b to sam: Awesome-list, czyli GitHub zamiast notatnika","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Zr\u00f3b<\/p>\n

<\/p>\n

Cze\u015b\u0107, Habr! Prawdopodobnie ka\u017cdy z nas ma taki plik, w kt\u00f3rym przechowuje co\u015b przydatnego i interesuj\u0105cego dla siebie. Jakie\u015b linki do artyku\u0142\u00f3w, ksi\u0105\u017cek, repozytori\u00f3w, podr\u0119cznik\u00f3w. Mog\u0105 to by\u0107 zak\u0142adki w przegl\u0105darce lub nawet po prostu otwarte karty, pozostawione na p\u00f3\u017aniej. Z czasem wszystko to narasta, linki przestaj\u0105 dzia\u0142a\u0107, a wi\u0119kszo\u015b\u0107 materia\u0142\u00f3w po prostu si\u0119 dezaktualizuje. <\/p>\n

<\/p>\n

A co je\u015bli podzieli\u0107 si\u0119 tym cennym materia\u0142em z spo\u0142eczno\u015bci\u0105 i opublikowa\u0107 ten plik na GitHubie? Wtedy twoje wysi\u0142ki mog\u0105 by\u0107 przydatne dla innych, a aktualizacj\u0119 mo\u017cna wsp\u00f3lnie utrzymywa\u0107, przyjmuj\u0105c aktualizacje od ch\u0119tnych poprzez stare dobre PR'y. W\u0142a\u015bnie w tym celu powsta\u0142 projekt Awesome lists<\/a><\/noindex>. Jest w czo\u0142\u00f3wce 10 repozytori\u00f3w na GitHubie, ma 138K gwiazdek, a link do Twoich materia\u0142\u00f3w mo\u017ce znale\u017a\u0107 si\u0119 bezpo\u015brednio w jego g\u0142\u00f3wnym README, co przyci\u0105gnie ogromn\u0105 publiczno\u015b\u0107 do Twojej tw\u00f3rczo\u015bci. Prawda, trzeba si\u0119 troch\u0119 postara\u0107. Chcia\u0142bym podzieli\u0107 si\u0119 z Wami moim do\u015bwiadczeniem w tym zakresie. <\/p>\n

<\/p>\n

Nazywam si\u0119 Maksym Gramin. W KROK zajmuj\u0119 si\u0119 rozwojem w Java i badaniami w dziedzinie baz danych. W tym po\u015bcie opowiem, czym s\u0105 Awesome Lists i jak stworzy\u0107 swoje w\u0142asne oficjalne awesome-repo.<\/p>\n

<\/a><\/noindex><\/p>\n

Czym s\u0105 Awesome Lists<\/h2>\n

<\/p>\n

Kiedy mam do czynienia z now\u0105 technologi\u0105 lub j\u0119zykiem programowania, pierwsze co robi\u0119, to id\u0119 w\u0142a\u015bnie tutaj \u2014 znajduj\u0119 odpowiedni\u0105 sekcj\u0119, a w niej odpowiednie listy. I s\u0105dz\u0105c po liczbie gwiazdek i ich sta\u0142ym wzro\u015bcie, nie tylko ja tak robi\u0119.
\n\"Zr\u00f3b<\/p>\n

<\/p>\n

Tak naprawd\u0119 \u2014 to zwyk\u0142y p\u0142aski readme.md, kt\u00f3ry \u017cyje w oddzielnym repozytorium<\/a><\/noindex>, zajmuj\u0105c przy tym 8. miejsce w\u015br\u00f3d wszystkich repozytori\u00f3w GitHub i zawieraj\u0105c odno\u015bniki do innych list po\u015bwi\u0119conych konkretnej tematyce. Na przyk\u0142ad w cz\u0119\u015bci J\u0119zyki Programowania mo\u017cna znale\u017a\u0107 listy Awesome Python i Awesome Go, a w Rozwoju Front-End jest ogromna ilo\u015b\u0107 zasob\u00f3w dotycz\u0105cych WEB. No i oczywi\u015bcie \u2014 sekcja Bazy Danych<\/a><\/noindex> (do kt\u00f3rej jeszcze wr\u00f3cimy troch\u0119 p\u00f3\u017aniej). I tak, wszystko to nie ogranicza si\u0119 tylko do temat\u00f3w technicznych. Na przyk\u0142ad, w sekcjach Rozrywka i Gry mo\u017cna tak\u017ce znale\u017a\u0107 wiele interesuj\u0105cych rzeczy (osobi\u015bcie ucieszy\u0142o mnie awesome-fantasy<\/a><\/noindex>).
\nG\u0142\u00f3wn\u0105 cech\u0105 jest to, \u017ce wszystkie te listy s\u0105 prowadzone nie przez autora, ale przez spo\u0142eczno\u015b\u0107 i s\u0105 opracowane zgodnie ze specjalnym i bardzo \u015bcis\u0142ym awesome manifesto<\/a><\/noindex>. Ka\u017cda taka lista jest samodzieln\u0105 spo\u0142eczno\u015bci\u0105 specjalist\u00f3w, \u017cyje swoim \u017cyciem i jest otwarta na twoje pull request'y, kt\u00f3re uczyni\u0105 j\u0105 jeszcze lepsz\u0105. Ka\u017cdy ch\u0119tny mo\u017ce r\u00f3wnie\u017c stworzy\u0107 w\u0142asn\u0105 list\u0119, je\u015bli jaki\u015b temat nie zosta\u0142 jeszcze poruszony.<\/p>\n

<\/p>\n

Autorem pomys\u0142u i koordynatorem ca\u0142ego tego przedsi\u0119wzi\u0119cia jest legendarna Sindre S\u00f8rhus, pierwsza osoba na GitHubie<\/a><\/noindex>, autor ponad 1000 modu\u0142\u00f3w npm,<\/a><\/noindex>, to w\u0142a\u015bnie on b\u0119dzie przyjmowa\u0142 Twoje PR-y.
\n\"Zr\u00f3b<\/p>\n

<\/p>\n

Jak dosta\u0107 si\u0119 do awesome-list<\/h2>\n

<\/p>\n

Je\u015bli przypadkiem nie znalaz\u0142e\u015b odpowiedniej listy na interesuj\u0105cy Ci\u0119 temat, to jest to pierwszy sygna\u0142, \u017ce warto j\u0105 stworzy\u0107 samemu!<\/p>\n

<\/p>\n

Opowiem na przyk\u0142adzie mojego dzie\u0142a Awesome Database Tools<\/a><\/noindex> \u2014 W projektach musz\u0119 pracowa\u0107 z r\u00f3\u017cnymi bazami danych, dlatego stworzy\u0142em taki plik, w kt\u00f3rym gromadzi\u0142em przydatne narz\u0119dzia do pracy z nimi, r\u00f3\u017cne migratory DB, IDE, panele administracyjne, narz\u0119dzia do monitorowania i inne. Narz\u0119dzia, kt\u00f3re ju\u017c wykorzysta\u0142em lub kt\u00f3re planowa\u0142em wykorzysta\u0107. Dzieli\u0142em si\u0119 tym plikiem z kolegami w KROK i poza nim. To pomog\u0142o wielu osobom i by\u0142o interesuj\u0105ce. W ko\u0144cu zapragn\u0105\u0142em wi\u0119kszej s\u0142awy, gdy pewnego dnia zauwa\u017cy\u0142em, \u017ce w sekcji Databases brakuje listy na ten temat. I postanowi\u0142em doda\u0107 tam swoj\u0105. <\/p>\n

<\/p>\n

Co jest potrzebne?<\/strong><\/p>\n

<\/p>\n

    \n
  1. Rejestrujemy zwyk\u0142e repozytorium na GitHubie o nazwie w rodzaju awesome-co\u015b-tam. W moim przypadku by\u0142o to awesome-database-tools.<\/li>\n
  2. Dostosowujemy swoj\u0105 list\u0119 do formatu awesome, w tym pomo\u017ce nam generator-awesome-list,<\/a><\/noindex>, kt\u00f3ry wygeneruje wszystkie potrzebne pliki w odpowiednim formacie.<\/li>\n
  3. Konfigurujemy prawdziwe CI. awesome-lint<\/a><\/noindex> i Travis CI pomog\u0105 nam kontrolowa\u0107 wa\u017cno\u015b\u0107<\/a><\/noindex> naszej listy.<\/li>\n
  4. Czekamy 30 dni. <\/li>\n
  5. Robimy przegl\u0105d co najmniej 2 obcych PR'\u00f3w<\/li>\n
  6. I w ko\u0144cu robimy PR do g\u0142\u00f3wnego repozytorium, gdzie dodajemy link do swojego repozytorium. Nale\u017cy uwa\u017cnie przeczyta\u0107 wszystko i dok\u0142adnie spe\u0142ni\u0107 wszystkie liczne wymagania dotycz\u0105ce nowej listy i samego PR.<\/li>\n<\/ol>\n

    <\/p>\n

    M\u00f3j pierwszy b\u0142\u0105d okaza\u0142 si\u0119 nietrafiony.<\/a><\/noindex>
    \n\"Zr\u00f3b
    \nAle min\u0119\u0142o troch\u0119 czasu, zebra\u0142em jeszcze wi\u0119cej materia\u0142\u00f3w, popracowa\u0142em nad b\u0142\u0119dami i odwa\u017cy\u0142em si\u0119 na     drug\u0105 pr\u00f3b\u0119.<\/a><\/noindex>.<\/p>\n

    <\/p>\n

    Ale zapomnia\u0142em o bardzo wa\u017cnej rzeczy, o kt\u00f3rej delikatnie mi przypomniano:
    \n\"Zr\u00f3b<\/p>\n

    <\/p>\n

    By\u0142em ma\u0142o uwa\u017cny i nie doda\u0142em jednoro\u017cca jako potwierdzenie, \u017ce wszystkie warunki zosta\u0142y spe\u0142nione.
    \n\"Zr\u00f3b<\/p>\n

    <\/p>\n

    Potem min\u0119\u0142o jeszcze troch\u0119 czasu, jeszcze kilka poprawek wed\u0142ug uwag i pojawi\u0142 si\u0119 d\u0142ugo oczekiwany tweet,<\/a><\/noindex>\u017ce m\u00f3j PR zosta\u0142 przyj\u0119ty.<\/p>\n

    <\/p>\n

    Tak sta\u0142em si\u0119 autorem swojej pierwszej listy, a zacz\u0119\u0142y przychodzi\u0107 mi PR'y<\/a><\/noindex> z spo\u0142eczno\u015bci dotycz\u0105ce dodawania nowych narz\u0119dzi. Wiele z nich ju\u017c zosta\u0142o uwzgl\u0119dnionych w Awesome Database Tools<\/a><\/noindex>. Je\u015bli nie chce Ci si\u0119 przechodzi\u0107 przez link, <\/p>\n

    <\/p>\n

    oto aktualny na moment publikacji posta zbi\u00f3r<\/b><\/p>\n

    Awesome Database Tools \"Zr\u00f3b<\/a><\/noindex><\/h1>\n

    <\/p>\n

    Spo\u0142eczno\u015bciowa lista narz\u0119dzi baz danych<\/p><\/blockquote>\n

    Tutaj zbierzemy informacje o niesamowitych u\u017cytecznych oraz rewelacyjnych eksperymentalnych narz\u0119dziach, kt\u00f3re u\u0142atwiaj\u0105 prac\u0119 z bazami danych dla DBA, DevOps, programist\u00f3w i zwyk\u0142ych ludzi.<\/p>\n

    <\/p>\n

    Czuj si\u0119 swobodnie, aby doda\u0107 informacje o w\u0142asnych narz\u0119dziach db lub ulubionych narz\u0119dziach os\u00f3b trzecich.<\/p>\n

    <\/p>\n

    Spis tre\u015bci<\/h2>\n

    <\/p>\n