diff --git a/README-de.md b/README-de.md index 7998f33..9da422f 100644 --- a/README-de.md +++ b/README-de.md @@ -18,6 +18,7 @@ Verfügbare Sprachen: - [English](./README.md) - [Français](./README-fr.md) - [Deutsch](./README-de.md) +- [Português](./README-pt.md) Eine Sprache fehlt und du möchtest helfen das Cheat Sheet zu verbessern? [Beteiligung ist gern gesehen](./CONTRIBUTING.md)! diff --git a/README-fr.md b/README-fr.md index ae4b60a..e2fb0f8 100644 --- a/README-fr.md +++ b/README-fr.md @@ -17,6 +17,7 @@ Langages disponibles : - [English](./README.md) - [Français](./README-fr.md) - [Deutsch](./README-de.md) +- [Português](./README-pt.md) Une langue est manquante ? Vous pensez qu'il est possible d'améliorer ce cheat sheet ? [Les contributions sont les bienvenues](./CONTRIBUTING.md) ! diff --git a/README-pt.md b/README-pt.md new file mode 100644 index 0000000..4141fcf --- /dev/null +++ b/README-pt.md @@ -0,0 +1,287 @@ +
+ +
+ ++ + + +
+ ++ +> Certifique-se de que o seu projecto é estável e tem um mínimo de características interessantes para envolver os visitantes. + +
++ +> Escolha um nome que seus visitantes se lembrem facilmente. + +
++ +> O README é a primeira coisa que os visitantes vêem na página do seu projeto. Trabalhe na apresentação para torná-la simples, bonita e agradável de ler. [Você encontrará exemplos de README tratados aqui.](https://github.com/matiassingers/awesome-readme) + +
++ +> Identificar os pontos fortes de seu projeto e colocá-los para a frente de modo que é a primeira coisa que seus visitantes vejam. + +
++ +> Seus visitantes vão querer entender rapidamente quais são as necessidades do seu projeto e como ele funciona. Fornecer uma demonstração é uma ótima maneira de satisfazer seus visitantes. O formato da demonstração pode ser: +> +> - um GIF animado +> - um link para uma demonstração online + +
++ +> Você pode perder visitantes se o projeto não for fácil de instalar ou usar. + +
++ +> Criar boa documentação é provavelmente o passo mais importante. Se sua documentação não for longa, você poderá incluí-la diretamente no seu README. Se for volumoso, o melhor será hospedá-lo em um site diferente. Alguns projetos de código aberto como o [vuepress](https://v1.vuepress.vuejs.org) podem criar rapidamente uma boa documentação. + +
++ +> A maioria dos visitantes olhará para o número de estrelas no projeto antes de usá-lo. Quanto mais estrelas o seu projecto tiver, maior será o seu índice de fiabilidade. Não hesite em pedir a seus parentes, colegas e amigos para ajudá-lo a melhorar a credibilidade do seu projeto adicionando uma estrela. + + +
++ +> Aqui estão algumas plataformas nas quais você pode compartilhar seu trabalho : +> +> - [Twitter](https://twitter.com) +> - [Linkedin](https://www.linkedin.com/) +> - [Facebook](https://www.facebook.com/) +> - [Reddit](https://www.reddit.com/) +> - [Dev.to](https://dev.to/) +> - [Lobsters](https://lobste.rs/) +> - [Hacker News](https://news.ycombinator.com/) +> - [Product Hunt](https://www.producthunt.com/) +> - [Beta page](https://betapage.co/) +> - [Human Coders](https://news.humancoders.com/) + +
++ +> Escreva artigos e cite seu projeto. O assunto do artigo pode estar relacionado com a pilha técnica que utilizou, os problemas que encontrou, etc. Postar nas plataformas de publicação: +> +> - [medium](https://medium.com/) +> - [dev.to](https://dev.to/) + +
++ +> Apresentar seu projeto em conferências e encontros é uma ótima maneira de melhorar sua visibilidade. + +
++ +> Gravar um vídeo não é um exercício fácil, mas é uma das maneiras mais eficazes de tornar seu projeto popular. + +
++ +> Normalmente, a melhor altura para iniciar uma comunicação é no meio da semana. Não comunicar durante os períodos de férias ou fins de semana. + +
++ +> Não publique duas vezes na mesma plataforma. Sua comunicação pode ser considerada spam e causar má publicidade para o seu projeto. + +
++ +> Mantenha e melhore seu projeto publicando novas versões. Não se esqueça de produzir os changelogs associados. + +
++ +> Não deixe problemas sem resposta. Seja cortês e simpático com as pessoas que tiveram tempo para abrir sugestões. 😉 + +
++ +> Um projeto saudável é um projeto que tem uma comunidade e colaboradores. Mostre aos seus utilizadores que sua ajuda é bem-vinda marcando alguns problemas com as etiquetas `contribution welcome` ou ` good first issue`. [Pode encontrar mais informações nas etiquetas clicando aqui.](https://help.github.com/en/articles/about-labels) + +
++ +> Alguns projetos open-source como o [gatsby](https://github.com/gatsbyjs/gatsby) recompensam seus colaboradores com goodies. Se você não puder pagar, faça uma publicação (no twitter ou em outras plataformas) que mencione a contribuição e seu autor para agradecê-lo (ex: [Post no twitter](https://twitter.com/FranckAbgrall/status/1139470547492978688)). Você também pode abrir uma seção `Contributors` no seu README para mostrar publicamente seus agradecimentos a seus colaboradores ou destacá-los em seu website ou documentação do projeto. +> +> - [vuepress (seção de contribuidores no README)](https://github.com/vuejs/vuepress#code-contributors) +> - [Rythm.js (Destacando de maneira aleatória um colaborador na página de demonstração)](https://okazari.github.io/Rythm.js/) + +
++ +> Os issues do Github nem sempre são a melhor maneira de se comunicar com seus utilizadores. Se necessário, você pode abrir um chat para conversar com eles : +> +> - [Discord](https://discordapp.com) +> - [Slack](https://slack.com) +> - [Gitter](https://gitter.im/) + +
++ +> O feedback dos utilizadores é uma excelente forma de melhorar o seu projecto. Seus utilizadores provavelmente têm muitas idéias que poderiam melhorar o seu projeto. +
+ ++ +> Os visitantes confiarão mais facilmente se virem casos concretos de uso (ex. : [vuepress gallery](https://vuepress.gallery/)). + +
+