diff --git a/README-zh-tw.md b/README-zh-tw.md new file mode 100644 index 0000000..255d9c2 --- /dev/null +++ b/README-zh-tw.md @@ -0,0 +1,288 @@ +
+ +
+ ++ + + +
+ ++ +> 您的項目必須足夠穩定,並且擁有一些最低可行功能用以吸引用戶們。 + +
++ +> 挑選一個用戶們能輕易記住的名字。 + +
++ +> 您的訪客們的第一件事就是閱讀您的README文檔,所以您得確保它幹淨漂亮、易於閱讀。[這些優秀的README文檔可以為您提供參考](https://github.com/matiassingers/awesome-readme). + +
++ +> 找出您的項目的強大之處並確保您的訪客們在第一時間了解到它們。 + +
++ +> 訪客們通常希望迅速了解您的項目的目標,它的工作原理以及應該如何使用它。為您的項目提供一個演示或者示例可以很好地滿足訪客們的需求,比如說: +> +> - 利用GIF動畫來展示您項目的工作原理 +> - 提供一個在線演示的網頁連接 + +
++ +> 您的項目不夠用戶友好可能會造成訪客們的流失。 + +
++ +> 一個優秀的文檔也許是最為重要的一步了。如果您的文檔比較小的話,您可以直接將它包含在README文檔裏。否則的話,您或許應該將您的文檔托管在一個獨立的網站上麵。一些開源項目比如 [vuepress](https://v1.vuepress.vuejs.org) 可以幫助您非常容易地創建幹淨整潔的文檔。 + +
++ +> 許多訪客會在考慮使用項目之前,先查看項目獲得過得star數量。隻需要一些star就能讓您的項目比沒有任何star的項目更加值得信賴,這就是為什麼您應該在社交網絡上公開宣布之前,請您認識的人支持您的項目。 + +
++ +> 向世界展示您無與倫比的作品!您可以在以下社交媒體和專業平台上發布: +> +> - [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/) + +
++ +> 為您的項目寫一些關於您項目的文章。您可以在其中分享您使用到的技術棧、您項目的工作原理和您遇到過得問題等等。然後把這些文章發布在這些平台上: +> +> - [medium](https://medium.com/) +> - [dev.to](https://dev.to/) +
++ +> 在正式會議或線下聚會上介紹您的項目是提高知名度的好辦法。 + +
++ +> 雖然錄製視頻並不輕鬆,但它也許是能讓您的項目出名的最有效的辦法。 + +
++ +> 不要在假期或者周末發布您的項目。通常最適合在社交網絡上發布的時間是一周裏中間的那幾天。 + +
++ +> 不要在相同的平台上發布兩次。這將會被視為過渡的宣傳,並且有可能為您的項目招致負麵宣傳。 + +
++ +> 維護並且改進您的項目,比如:新版本的發布和撰寫變更記錄。 + +
++ +> 別讓issue一直處於未解決的狀態並且對此毫無回應。對那些花費自己時間提交issue的用戶們好一點。 😉 + +
++ +> 一個健康的項目通常擁有一個社區和許多貢獻者們。在一些issue上標注`contribution welcome`標簽或者`good first issue`標簽來讓您的用戶們知道您需要幫助。[關於github標簽](https://help.github.com/en/articles/about-labels). + +
++ +> 為那些幫助過您的人們鼓掌喝彩! 一些開源項目像是[gatsby](https://github.com/gatsbyjs/gatsby)會獎勵貢獻者們一些小禮物。如果您負擔不起,也可以在twitter或者其它平台上發布一封關於項目貢獻的公開感謝信,並且提及那些貢獻者們([公開感謝信的示例](https://twitter.com/FranckAbgrall/status/1139470547492978688))。在您的README文檔裏開設一個`貢獻者`欄,以此公開地感謝貢獻者們。或者您也可以在項目文檔或網站上展示您的貢獻者們。以下是一些示例: +> +> - [vuepress (在README中的貢獻者欄)](https://github.com/vuejs/vuepress#code-contributors) +> - [Rythm.js (在展示頁麵上隨機顯示貢獻者)](https://okazari.github.io/Rythm.js/) + +
++ +> Github的issue並不總是和您的用戶溝通最好的地方。如果有需要的話,您可以使用一些聊天平台來和他們討論: +> +> - [Discord](https://discordapp.com) +> - [Slack](https://slack.com) +> - [Gitter](https://gitter.im/) + +
++ +> 用戶反饋是改進您項目的最佳方法,他們也許有著能使您的項目變得更好的想法和主意。 + +
++ +> 如果訪問者們能夠見到具體的用例和成功案例的話,他們會更加信任您的項目,比如 [the vuepress gallery](https://vuepress.gallery/). + +
+Franck Abgrall 📖 |
+ Thomas Betous 📖 |
+ Eric Briand 📖 |
+ Faustine Godbillot 📖 |
+ Benjamin Plouzennec 📖 |
+ Johan Bonneau 📖 |
+ Benjamin Petetot 📖 |
+
NickHatBoecker 🌍 |
+ Claire Martinez 🌍 |
+ André Gama 📖 |
+