{"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\/pt\/blog\/administrirovanie\/awesome-list-svoimi-rukami-ili-github-vmesto-bloknota","title":{"rendered":"Lista incr\u00edvel feita \u00e0 m\u00e3o, ou GitHub em vez de bloco de notas","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Lista<\/p>\n

<\/p>\n

Ol\u00e1, Habr! Provavelmente, cada um de n\u00f3s tem aquele arquivo onde guardamos algo \u00fatil e interessante para n\u00f3s mesmos. Links para artigos, livros, reposit\u00f3rios, manuais. Podem ser favoritos no navegador ou at\u00e9 mesmo apenas abas abertas, deixadas para depois. Com o tempo, tudo isso cresce, os links param de funcionar e a maior parte do material simplesmente fica desatualizado. <\/p>\n

<\/p>\n

E se compartilh\u00e1ssemos essa qualidade com a comunidade e coloc\u00e1ssemos esse arquivo no GitHub? Assim, seu trabalho pode ser \u00fatil para outra pessoa, e a manuten\u00e7\u00e3o da atualidade pode ser feita em conjunto, aceitando atualiza\u00e7\u00f5es de interessados atrav\u00e9s dos bons e velhos PRs. Este projeto \u00e9 exatamente para isso. Awesome lists<\/a><\/noindex>. Ele est\u00e1 entre os 10 principais reposit\u00f3rios do GitHub, possui 138 mil estrelas, e o link para suas contribui\u00e7\u00f5es pode acabar diretamente no seu README principal, o que atrair\u00e1 um enorme p\u00fablico para sua cria\u00e7\u00e3o. No entanto, para isso, ser\u00e1 preciso se esfor\u00e7ar um pouco. Quero compartilhar com voc\u00eas minha experi\u00eancia com esses esfor\u00e7os. <\/p>\n

<\/p>\n

Meu nome \u00e9 Maxim Gramin. Na KROK, trabalho com desenvolvimento em Java e pesquisas na \u00e1rea de bancos de dados. Neste post, vou explicar o que s\u00e3o Awesome Lists e como criar seu verdadeiro reposit\u00f3rio awesome oficial.<\/p>\n

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

O que s\u00e3o Awesome Lists<\/h2>\n

<\/p>\n

Quando preciso me aprofundar em uma nova tecnologia ou linguagem de programa\u00e7\u00e3o, a primeira coisa que fa\u00e7o \u00e9 ir at\u00e9 aqui \u2014 encontro a se\u00e7\u00e3o que preciso e, dentro dela, as listas adequadas. E pelo n\u00famero de estrelas e seu crescimento constante, n\u00e3o sou o \u00fanico que faz isso.
\n\"Lista<\/p>\n

<\/p>\n

Na verdade, \u00e9 apenas um readme.md simples, que vive em um diret\u00f3rio separado reposit\u00f3rio<\/a><\/noindex>, ocupando o 8\u00ba lugar entre todos os reposit\u00f3rios do GitHub e incluindo links para outras listas dedicadas a um determinado tema. Por exemplo, na se\u00e7\u00e3o Linguagens de Programa\u00e7\u00e3o, voc\u00ea pode encontrar listas como Awesome Python e Awesome Go, e em Desenvolvimento Front-End h\u00e1 uma enorme quantidade de recursos sobre desenvolvimento WEB. E, claro, a se\u00e7\u00e3o Databases<\/a><\/noindex> (voltaremos a isso mais tarde). E sim, tudo isso n\u00e3o se limita apenas a temas t\u00e9cnicos. Por exemplo, nas se\u00e7\u00f5es Entertainment e Gaming tamb\u00e9m \u00e9 poss\u00edvel encontrar muitas coisas interessantes (pessoalmente, fiquei encantado com awesome-fantasy<\/a><\/noindex>).
\nA principal caracter\u00edstica \u00e9 que todas essas listas s\u00e3o mantidas n\u00e3o apenas pelo autor, mas pela comunidade e s\u00e3o elaboradas de acordo com um manifesto especial e muito rigoroso. awesome manifesto<\/a><\/noindex>. Cada uma dessas listas \u00e9 uma comunidade independente de especialistas, vive sua pr\u00f3pria vida e est\u00e1 aberta para os seus pull requests, que a tornar\u00e3o ainda melhor. Qualquer pessoa interessada pode criar sua pr\u00f3pria lista, caso algum tema ainda n\u00e3o tenha sido abordado.<\/p>\n

<\/p>\n

O autor da ideia e coordenador de tudo isso \u00e9 o lend\u00e1rio Sindre Sorhus, o primeiro usu\u00e1rio no GitHub<\/a><\/noindex>, autor de mais de 1000 m\u00f3dulos npm,<\/a><\/noindex>, e ele ser\u00e1 respons\u00e1vel por aceitar seus PRs.
\n\"Lista<\/p>\n

<\/p>\n

Como entrar na awesome-list<\/h2>\n

<\/p>\n

Se voc\u00ea n\u00e3o encontrou uma lista adequada sobre o tema que lhe interessa, isso \u00e9 um sinal de que voc\u00ea mesmo deve cri\u00e1-la!<\/p>\n

<\/p>\n

Vou explicar com o exemplo do meu projeto, Awesome Database Tools.<\/a><\/noindex> \u2014 De projeto em projeto, sou obrigado a trabalhar com os mais diversos bancos de dados, e por isso criei um arquivo onde reunia ferramentas \u00fateis para trabalhar com eles, v\u00e1rios migradores de BD, IDEs, pain\u00e9is de administra\u00e7\u00e3o, ferramentas de monitora\u00e7\u00e3o e muito mais. Ferramentas que j\u00e1 usei ou que estava apenas planejando come\u00e7ar a usar. Compartilhei esse arquivo com colegas na K\u0420O\u041a e fora dela. Isso ajudou muitas pessoas e gerou interesse. No final, eu queria mais reconhecimento, quando percebi que na se\u00e7\u00e3o de Databases n\u00e3o havia uma lista sobre esse tema. Ent\u00e3o decidi adicionar a minha. <\/p>\n

<\/p>\n

O que \u00e9 necess\u00e1rio para isso?<\/strong><\/p>\n

<\/p>\n

    \n
  1. Registre um reposit\u00f3rio normal no GitHub com um nome do tipo awesome-algo-a\u00ed. No meu caso, foi awesome-database-tools.<\/li>\n
  2. Torne sua lista compat\u00edvel com o formato awesome, para isso usaremos generator-awesome-list,<\/a><\/noindex>que gerar\u00e1 todos os arquivos necess\u00e1rios no formato correto.<\/li>\n
  3. Configure um verdadeiro CI. awesome-lint<\/a><\/noindex> e travis ci nos ajudar\u00e3o a controlar a validade<\/a><\/noindex> da nossa lista.<\/li>\n
  4. Aguarde 30 dias. <\/li>\n
  5. Fazemos revis\u00e3o de pelo menos 2 PRs de outras pessoas<\/li>\n
  6. E, finalmente, fa\u00e7a um PR no reposit\u00f3rio principal, onde adicionamos o link para o nosso reposit\u00f3rio. Aqui, \u00e9 preciso ler tudo com aten\u00e7\u00e3o e seguir todos os diversos requisitos para a nova lista e para o pr\u00f3prio PR.<\/li>\n<\/ol>\n

    <\/p>\n

    Meu primeiro teste saiu errado.<\/a><\/noindex>
    \n\"Lista
    \nMas passou um tempo, eu reuni ainda mais material, trabalhei nos erros e me atrevi a fazer     uma segunda tentativa.<\/a><\/noindex>.<\/p>\n

    <\/p>\n

    Mas eu esqueci de uma coisa muito importante, que me foi gentilmente lembrada:
    \n\"Lista<\/p>\n

    <\/p>\n

    Eu n\u00e3o prestei muita aten\u00e7\u00e3o e n\u00e3o adicionei um unic\u00f3rnio como sinal de que todas as condi\u00e7\u00f5es foram cumpridas.
    \n\"Lista<\/p>\n

    <\/p>\n

    Depois passou mais algum tempo, mais algumas corre\u00e7\u00f5es foram feitas e a t\u00e3o esperada men\u00e7\u00e3o no Twitter<\/a><\/noindex>, informando que meu PR foi aceito.<\/p>\n

    <\/p>\n

    Assim, tornei-me autor da minha primeira lista e comecei a receber PRs<\/a><\/noindex> da comunidade para a adi\u00e7\u00e3o de novas ferramentas. E muitas delas j\u00e1 est\u00e3o inclu\u00eddas em Awesome Database Tools.<\/a><\/noindex>. Se voc\u00ea n\u00e3o quer clicar no link, <\/p>\n

    <\/p>\n

    aqui est\u00e1 uma cole\u00e7\u00e3o atual no momento da publica\u00e7\u00e3o do post<\/b><\/p>\n

    Awesome Database Tools. \"Lista<\/a><\/noindex><\/h1>\n

    <\/p>\n

    Lista de ferramentas de banco de dados impulsionada pela comunidade<\/p><\/blockquote>\n

    Aqui coletaremos informa\u00e7\u00f5es sobre ferramentas incr\u00edveis \u00fateis e experimentais que facilitam o trabalho com bancos de dados para DBAs, DevOps, desenvolvedores e mortais comuns.<\/p>\n

    <\/p>\n

    Sinta-se \u00e0 vontade para adicionar informa\u00e7\u00f5es sobre suas pr\u00f3prias ferramentas de banco de dados ou suas ferramentas de terceiros favoritas.<\/p>\n

    <\/p>\n

    Conte\u00fados<\/h2>\n

    <\/p>\n