├── .github ├── CODEOWNERS └── ISSUE_TEMPLATE │ ├── language-support-suggestion.md │ └── content-suggestion.md ├── imgs ├── cheat-sheet.jpg └── zoss-logo.svg ├── pdf └── cheat-sheet.pdf ├── LICENSE ├── CONTRIBUTING.md ├── CODE_OF_CONDUCT.md ├── .all-contributorsrc ├── README-zh-cn.md ├── README-zh-tw.md ├── README-jp.md ├── README-ar.md ├── README-fa.md ├── README-tr.md ├── README-si.md ├── README.md ├── README-id.md └── README-de.md /.github/CODEOWNERS: -------------------------------------------------------------------------------- 1 | * @nlepage 2 | -------------------------------------------------------------------------------- /imgs/cheat-sheet.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zenika-open-source/promote-open-source-project/HEAD/imgs/cheat-sheet.jpg -------------------------------------------------------------------------------- /pdf/cheat-sheet.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zenika-open-source/promote-open-source-project/HEAD/pdf/cheat-sheet.pdf -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/language-support-suggestion.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Language support suggestion 3 | about: Suggest new language support 4 | title: 'New language support suggestion : French' 5 | labels: '' 6 | assignees: '' 7 | 8 | --- 9 | 10 | **I would like to ...** 11 | 12 | - [ ] offer my help to translate this cheat sheet in another language 13 | - [ ] ask if someone can translate this cheat sheet in another language 14 | 15 | **What is the language you would see this cheat sheet translate ?** 16 | Add the language you want 17 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/content-suggestion.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Content suggestion 3 | about: Suggest a content modification 4 | title: '' 5 | labels: '' 6 | assignees: '' 7 | 8 | --- 9 | 10 | **I would like to ...** 11 | 12 | - [ ] to modify content 13 | - [ ] to add content 14 | 15 | **What is the section concerned ?** 16 | Add the section concerned (e.g. 2. :loudspeaker: Spread the word about your hard works) 17 | 18 | **What is the point concerned ?** 19 | Add the point concerned or the point you would like to add (e.g. :microphone: Present your project at conferences/meetups 20 | 21 | **What would you like to add or modify ?** 22 | Explain what you would like to add or modify. If it is about new content, specify where you would like to add the content. 23 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2019 Zenika Open Source 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing 2 | 3 | Contributions, issues and feature requests are very welcome. If you want improve this cheat sheet or translate it in another languages, please consider opening an issue ! We will discuss it with you. 4 | 5 | If you want to contribute you must read and accept out [Code of Conduct](./CODE_OF_CONDUCT.md) 6 | 7 | ## Guidelines 8 | 9 | ### General guidelines 10 | 11 | - The master branch is the official document. 12 | - All new translations / suggestions should be done in dedicated branch from the `master` branch. 13 | - It's a very nice thing to have multiple small commits as you work on the PR. It's easier to review it. Then we will squash it before merging. 14 | 15 | ### Commit messages 16 | 17 | This project uses [gitmoji](https://gitmoji.carloscuesta.me/) as commit convention, because it's fun and provides an easy way of identifying the purpose or intention of a commit with only looking at the emojis used. All you just have to do is to find the emoji corresponding to the purpose of your commit in [this list](https://gitmoji.carloscuesta.me/) following by a short message explaining the update. You can also add a description if it's needed. That's all ;) 18 | 19 | https://gitmoji.carloscuesta.me/ 20 | 21 | ### Adding new translation or having a suggestion 22 | 23 | Ideally you should open a suggestion issue on [GitHub](https://github.com/zenika-open-source/how-to-promote-my-open-source/issues). 24 | -------------------------------------------------------------------------------- /imgs/zoss-logo.svg: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Covenant Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. 6 | 7 | ## Our Standards 8 | 9 | Examples of behavior that contributes to creating a positive environment include: 10 | 11 | - Using welcoming and inclusive language 12 | - Being respectful of differing viewpoints and experiences 13 | - Gracefully accepting constructive criticism 14 | - Focusing on what is best for the community 15 | - Showing empathy towards other community members 16 | 17 | Examples of unacceptable behavior by participants include: 18 | 19 | - The use of sexualized language or imagery and unwelcome sexual attention or advances 20 | - Trolling, insulting/derogatory comments, and personal or political attacks 21 | - Public or private harassment 22 | - Publishing others' private information, such as a physical or electronic address, without explicit permission 23 | - Other conduct which could reasonably be considered inappropriate in a professional setting 24 | 25 | ## Our Responsibilities 26 | 27 | Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. 28 | 29 | Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. 30 | 31 | ## Scope 32 | 33 | This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. 34 | 35 | ## Enforcement 36 | 37 | Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at franck.abgrall@zenika.com or thomas.betous@zenika.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. 38 | 39 | Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. 40 | 41 | ## Attribution 42 | 43 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] 44 | 45 | [homepage]: http://contributor-covenant.org 46 | [version]: http://contributor-covenant.org/version/1/4/ 47 | -------------------------------------------------------------------------------- /.all-contributorsrc: -------------------------------------------------------------------------------- 1 | { 2 | "files": [ 3 | "README.md", 4 | "README-ar.md", 5 | "README-ca.md", 6 | "README-de.md", 7 | "README-es.md", 8 | "README-fa.md", 9 | "README-fr.md", 10 | "README-id.md", 11 | "README-it.md", 12 | "README-jp.md", 13 | "README-pt.md", 14 | "README-ru.md", 15 | "README-si.md", 16 | "README-tr.md", 17 | "README-zh-cn.md", 18 | "README-zh-tw.md" 19 | ], 20 | "imageSize": 100, 21 | "commit": true, 22 | "commitConvention": "gitmoji", 23 | "contributors": [ 24 | { 25 | "login": "kefranabg", 26 | "name": "Franck Abgrall", 27 | "avatar_url": "https://avatars3.githubusercontent.com/u/9840435?v=4", 28 | "profile": "https://www.franck-abgrall.me/", 29 | "contributions": [ 30 | "doc" 31 | ] 32 | }, 33 | { 34 | "login": "tbetous", 35 | "name": "Thomas Betous", 36 | "avatar_url": "https://avatars3.githubusercontent.com/u/4435536?v=4", 37 | "profile": "https://github.com/tbetous", 38 | "contributions": [ 39 | "doc" 40 | ] 41 | }, 42 | { 43 | "login": "ebriand", 44 | "name": "Eric Briand", 45 | "avatar_url": "https://avatars1.githubusercontent.com/u/1011902?v=4", 46 | "profile": "https://github.com/ebriand", 47 | "contributions": [ 48 | "doc" 49 | ] 50 | }, 51 | { 52 | "login": "FaustineG", 53 | "name": "Faustine Godbillot", 54 | "avatar_url": "https://avatars.githubusercontent.com/u/27639429?v=4", 55 | "profile": "https://github.com/FaustineG", 56 | "contributions": [ 57 | "doc" 58 | ] 59 | }, 60 | { 61 | "login": "Okazari", 62 | "name": "Benjamin Plouzennec", 63 | "avatar_url": "https://avatars1.githubusercontent.com/u/5747538?v=4", 64 | "profile": "https://myvirtualstorybook.com/", 65 | "contributions": [ 66 | "doc" 67 | ] 68 | }, 69 | { 70 | "login": "Zenigata", 71 | "name": "Johan Bonneau", 72 | "avatar_url": "https://avatars1.githubusercontent.com/u/1022393?v=4", 73 | "profile": "https://github.com/Zenigata", 74 | "contributions": [ 75 | "doc" 76 | ] 77 | }, 78 | { 79 | "login": "bpetetot", 80 | "name": "Benjamin Petetot", 81 | "avatar_url": "https://avatars3.githubusercontent.com/u/516360?v=4", 82 | "profile": "https://github.com/bpetetot", 83 | "contributions": [ 84 | "doc" 85 | ] 86 | }, 87 | { 88 | "login": "NickHatBoecker", 89 | "name": "NickHatBoecker", 90 | "avatar_url": "https://avatars0.githubusercontent.com/u/8366071?v=4", 91 | "profile": "https://nick-hat-boecker.de", 92 | "contributions": [ 93 | "translation" 94 | ] 95 | }, 96 | { 97 | "login": "claire", 98 | "name": "Claire Martinez", 99 | "avatar_url": "https://avatars2.githubusercontent.com/u/5114096?v=4", 100 | "profile": "https://github.com/Claire", 101 | "contributions": [ 102 | "translation" 103 | ] 104 | }, 105 | { 106 | "login": "andregamma", 107 | "name": "André Gama", 108 | "avatar_url": "https://avatars2.githubusercontent.com/u/31011359?v=4", 109 | "profile": "https://hazeforum.com/", 110 | "contributions": [ 111 | "doc" 112 | ] 113 | }, 114 | { 115 | "login": "mbernardeau", 116 | "name": "Mathias Bernardeau", 117 | "avatar_url": "https://avatars0.githubusercontent.com/u/7049049?v=4", 118 | "profile": "https://github.com/mbernardeau", 119 | "contributions": [ 120 | "doc" 121 | ] 122 | }, 123 | { 124 | "login": "Antoineoili", 125 | "name": "Antoine Oili", 126 | "avatar_url": "https://avatars1.githubusercontent.com/u/50737365?v=4", 127 | "profile": "https://github.com/Antoineoili", 128 | "contributions": [ 129 | "doc" 130 | ] 131 | }, 132 | { 133 | "login": "dev-oswld", 134 | "name": "Oswld TC", 135 | "avatar_url": "https://avatars1.githubusercontent.com/u/40254158?v=4", 136 | "profile": "https://twitter.com/dev_oswld", 137 | "contributions": [ 138 | "translation" 139 | ] 140 | }, 141 | { 142 | "login": "ZhiyueYi", 143 | "name": "Zhiyue Yi", 144 | "avatar_url": "https://avatars3.githubusercontent.com/u/8545277?v=4", 145 | "profile": "https://yizhiyue.me", 146 | "contributions": [ 147 | "translation" 148 | ] 149 | }, 150 | { 151 | "login": "aliruss", 152 | "name": "Ali khalili", 153 | "avatar_url": "https://avatars3.githubusercontent.com/u/32896351?v=4", 154 | "profile": "https://github.com/aliruss", 155 | "contributions": [ 156 | "translation" 157 | ] 158 | }, 159 | { 160 | "login": "niusha-paks", 161 | "name": "Niusha Pakseresht", 162 | "avatar_url": "https://avatars3.githubusercontent.com/u/9018054?v=4", 163 | "profile": "https://pakseresht.eu/", 164 | "contributions": [ 165 | "translation" 166 | ] 167 | }, 168 | { 169 | "login": "david-dasilva", 170 | "name": "David Da Silva", 171 | "avatar_url": "https://avatars1.githubusercontent.com/u/372391?v=4", 172 | "profile": "https://github.com/david-dasilva", 173 | "contributions": [ 174 | "translation" 175 | ] 176 | }, 177 | { 178 | "login": "umutphp", 179 | "name": "Umut Işık", 180 | "avatar_url": "https://avatars2.githubusercontent.com/u/3245166?v=4", 181 | "profile": "http://umuts.info", 182 | "contributions": [ 183 | "translation" 184 | ] 185 | }, 186 | { 187 | "login": "alextremp", 188 | "name": "Alex Castells", 189 | "avatar_url": "https://avatars0.githubusercontent.com/u/20399660?v=4", 190 | "profile": "https://github.com/alextremp", 191 | "contributions": [ 192 | "translation" 193 | ] 194 | }, 195 | { 196 | "login": "koji", 197 | "name": "Koji", 198 | "avatar_url": "https://avatars0.githubusercontent.com/u/474225?v=4", 199 | "profile": "https://kojikoji.ga", 200 | "contributions": [ 201 | "translation" 202 | ] 203 | }, 204 | { 205 | "login": "MasterBrian99", 206 | "name": "pasindu p konghawaththa", 207 | "avatar_url": "https://avatars0.githubusercontent.com/u/37585474?v=4", 208 | "profile": "https://github.com/MasterBrian99", 209 | "contributions": [ 210 | "translation" 211 | ] 212 | }, 213 | { 214 | "login": "hackthedev", 215 | "name": "Marcel", 216 | "avatar_url": "https://avatars.githubusercontent.com/u/40896559?v=4", 217 | "profile": "http://adsoleware.com/", 218 | "contributions": [ 219 | "doc" 220 | ] 221 | }, 222 | { 223 | "login": "eltociear", 224 | "name": "Ikko Ashimine", 225 | "avatar_url": "https://avatars.githubusercontent.com/u/22633385?v=4", 226 | "profile": "https://bandism.net/", 227 | "contributions": [ 228 | "doc" 229 | ] 230 | }, 231 | { 232 | "login": "nlepage", 233 | "name": "Nicolas Lepage", 234 | "avatar_url": "https://avatars.githubusercontent.com/u/19571875?v=4", 235 | "profile": "https://github.com/nlepage", 236 | "contributions": [ 237 | "maintenance" 238 | ] 239 | }, 240 | { 241 | "login": "sergey-scat", 242 | "name": "Sergey Scat", 243 | "avatar_url": "https://avatars.githubusercontent.com/u/31442538?v=4", 244 | "profile": "https://github.com/sergey-scat", 245 | "contributions": [ 246 | "translation" 247 | ] 248 | }, 249 | { 250 | "login": "JustE3saR", 251 | "name": "Mohammed Taha", 252 | "avatar_url": "https://avatars.githubusercontent.com/u/62352949?v=4", 253 | "profile": "https://github.com/JustE3saR", 254 | "contributions": [ 255 | "translation" 256 | ] 257 | }, 258 | { 259 | "login": "Tazminia", 260 | "name": "T. JEGHAM", 261 | "avatar_url": "https://avatars.githubusercontent.com/u/41241424?v=4", 262 | "profile": "https://github.com/Tazminia", 263 | "contributions": [ 264 | "review" 265 | ] 266 | }, 267 | { 268 | "login": "Tarektouati", 269 | "name": "Tarek Touati", 270 | "avatar_url": "https://avatars.githubusercontent.com/u/19335073?v=4", 271 | "profile": "https://github.com/Tarektouati", 272 | "contributions": [ 273 | "review" 274 | ] 275 | }, 276 | { 277 | "login": "simonecorsi", 278 | "name": "Simone Corsi", 279 | "avatar_url": "https://avatars.githubusercontent.com/u/5617452?v=4", 280 | "profile": "https://github.com/simonecorsi", 281 | "contributions": [ 282 | "translation" 283 | ] 284 | }, 285 | { 286 | "login": "atogue", 287 | "name": "Anicet Togue", 288 | "avatar_url": "https://avatars.githubusercontent.com/u/5642182?v=4", 289 | "profile": "https://github.com/atogue", 290 | "contributions": [ 291 | "review" 292 | ] 293 | }, 294 | { 295 | "login": "Gerappa92", 296 | "name": "Krzysztof Juszcze", 297 | "avatar_url": "https://avatars.githubusercontent.com/u/17763895?v=4", 298 | "profile": "https://www.linkedin.com/in/krzysztof-juszcze-01b395118/", 299 | "contributions": [ 300 | "doc" 301 | ] 302 | }, 303 | { 304 | "login": "HanzCEO", 305 | "name": "Hanz", 306 | "avatar_url": "https://avatars.githubusercontent.com/u/40712686?v=4", 307 | "profile": "https://godot.id/", 308 | "contributions": [ 309 | "translation" 310 | ] 311 | }, 312 | { 313 | "login": "RSurya99", 314 | "name": "Rafli Surya P", 315 | "avatar_url": "https://avatars.githubusercontent.com/u/73375663?v=4", 316 | "profile": "https://github.com/RSurya99", 317 | "contributions": [ 318 | "doc" 319 | ] 320 | }, 321 | { 322 | "login": "kurt-liao", 323 | "name": "Kurt", 324 | "avatar_url": "https://avatars.githubusercontent.com/u/32745146?v=4", 325 | "profile": "https://github.com/kurt-liao", 326 | "contributions": [ 327 | "doc" 328 | ] 329 | }, 330 | { 331 | "login": "JumperBot", 332 | "name": "JumperBot_", 333 | "avatar_url": "https://avatars.githubusercontent.com/u/88363421?v=4", 334 | "profile": "https://youtube.com/channel/UCp7-e58oTMBArfCeiSooISA", 335 | "contributions": [ 336 | "doc" 337 | ] 338 | } 339 | ], 340 | "contributorsPerLine": 7, 341 | "projectName": "promote-open-source-project", 342 | "projectOwner": "zenika-open-source", 343 | "repoType": "github", 344 | "repoHost": "https://github.com", 345 | "skipCi": true 346 | } 347 | -------------------------------------------------------------------------------- /README-zh-cn.md: -------------------------------------------------------------------------------- 1 |
2 |
3 |
6 |
7 |
8 |
9 |
45 | 46 | > 您的项目必须足够稳定,并且拥有一些最低可行功能用以吸引用户们。 47 | 48 |
49 |54 | 55 | > 挑选一个用户们能轻易记住的名字。 56 | 57 |
58 |63 | 64 | > 您的访客们的第一件事就是阅读您的 README 文档,所以您得确保它干净漂亮、易于阅读。[这些优秀的 README 文档可以为您提供参考](https://github.com/matiassingers/awesome-readme)。 65 | 66 |
67 |72 | 73 | > 找出您的项目的强大之处并确保您的访客们在第一时间了解到它们。 74 | 75 |
76 |81 | 82 | > 访客们通常希望迅速了解您的项目的目标,它的工作原理以及应该如何使用它。为您的项目提供一个演示或者示例可以很好地满足访客们的需求,比如说: 83 | > 84 | > - 利用 GIF 动画来展示您项目的工作原理 85 | > - 提供一个在线演示的网页连接 86 | 87 |
88 |93 | 94 | > 您的项目不够用户友好可能会造成访客们的流失。 95 | 96 |
97 |102 | 103 | > 一个优秀的文档也许是最为重要的一步了。如果您的文档比较小的话,您可以直接将它包含在 README 文档里。否则的话,您或许应该将您的文档托管在一个独立的网站上面。一些开源项目比如 [vuepress](https://v1.vuepress.vuejs.org) 可以帮助您非常容易地创建干净整洁的文档。 104 | 105 |
106 |117 | 118 | > 许多访客会在考虑使用项目之前,先查看项目获得过得 star 数量。只需要一些 star 就能让您的项目比没有任何 star 的项目更加值得信赖,这就是为什么您应该在社交网络上公开宣布之前,请您认识的人支持您的项目。 119 | 120 |
121 |126 | 127 | > 向世界展示您无与伦比的作品!您可以在以下社交媒体和专业平台上发布: 128 | > 129 | > - [Twitter](https://twitter.com) 130 | > - [Linkedin](https://www.linkedin.com/) 131 | > - [Facebook](https://www.facebook.com/) 132 | > - [Reddit](https://www.reddit.com/) 133 | > - [Dev.to](https://dev.to/) 134 | > - [Lobsters](https://lobste.rs/) 135 | > - [Hacker News](https://news.ycombinator.com/) 136 | > - [Product Hunt](https://www.producthunt.com/) 137 | > - [Beta page](https://betapage.co/) 138 | > - [Human Coders](https://news.humancoders.com/) 139 | 140 |
141 |146 | 147 | > 为您的项目写一些关于您项目的文章。您可以在其中分享您使用到的技术栈、您项目的工作原理和您遇到过得问题等等。然后把这些文章发布在这些平台上: 148 | > 149 | > - [medium](https://medium.com/) 150 | > - [dev.to](https://dev.to/) 151 | 152 |
153 |158 | 159 | > 在正式会议或线下聚会上介绍您的项目是提高知名度的好办法。 160 | 161 |
162 |167 | 168 | > 虽然录制视频并不轻松,但它也许是能让您的项目出名的最有效的办法。 169 | 170 |
171 |176 | 177 | > 不要在假期或者周末发布您的项目。通常最适合在社交网络上发布的时间是一周里中间的那几天。 178 | 179 |
180 |185 | 186 | > 不要在相同的平台上发布两次。这将会被视为过度的宣传,并且有可能为您的项目招致负面宣传。 187 | 188 |
189 |200 | 201 | > 维护并且改进您的项目,比如:新版本的发布和撰写变更记录。 202 | 203 |
204 |209 | 210 | > 别让 issue 一直处于未解决的状态并且对此毫无回应。对那些花费自己时间提交 issue 的用户们好一点。 😉 211 | 212 |
213 |218 | 219 | > 一个健康的项目通常拥有一个社区和许多贡献者们。在一些 issue 上标注`contribution welcome`标签或者`good first issue`标签来让您的用户们知道您需要帮助。[关于 github 标签](https://help.github.com/en/articles/about-labels)。 220 | 221 |
222 |227 | 228 | > 为那些帮助过您的人们鼓掌喝彩! 一些开源项目像是[gatsby](https://github.com/gatsbyjs/gatsby)会奖励贡献者们一些小礼物。如果您负担不起,也可以在 twitter 或者其它平台上发布一封关于项目贡献的公开感谢信,并且提及那些贡献者们([公开感谢信的示例](https://twitter.com/FranckAbgrall/status/1139470547492978688))。在您的 README 文档里开设一个`贡献者`栏,以此公开地感谢贡献者们。或者您也可以在项目文档或网站上展示您的贡献者们。以下是一些示例: 229 | > 230 | > - [vuepress (在 README 中的贡献者栏)](https://github.com/vuejs/vuepress#code-contributors) 231 | > - [Rythm.js (在展示页面上随机显示贡献者)](https://okazari.github.io/Rythm.js/) 232 | 233 |
234 |239 | 240 | > Github 的 issue 并不总是和您的用户沟通最好的地方。如果有需要的话,您可以使用一些聊天平台来和他们讨论: 241 | > 242 | > - [Discord](https://discord.com) 243 | > - [Slack](https://slack.com) 244 | > - [Gitter](https://gitter.im/) 245 | 246 |
247 |252 | 253 | > 用户反馈是改进您项目的最佳方法,他们也许有着能使您的项目变得更好的想法和主意。 254 | 255 |
256 |261 | 262 | > 如果访问者们能够见到具体的用例和成功案例的话,他们会更加信任您的项目,比如 [the vuepress gallery](https://vuepress.gallery/)。 263 | 264 |
265 |Franck Abgrall 📖 |
285 | Thomas Betous 📖 |
286 | Eric Briand 📖 |
287 | Faustine Godbillot 📖 |
288 | Benjamin Plouzennec 📖 |
289 | Johan Bonneau 📖 |
290 | Benjamin Petetot 📖 |
291 |
NickHatBoecker 🌍 |
294 | Claire Martinez 🌍 |
295 | André Gama 📖 |
296 | Mathias Bernardeau 📖 |
297 | Antoine Oili 📖 |
298 | Oswld TC 🌍 |
299 | Zhiyue Yi 🌍 |
300 |
Ali khalili 🌍 |
303 | Niusha Pakseresht 🌍 |
304 | David Da Silva 🌍 |
305 | Umut Işık 🌍 |
306 | Alex Castells 🌍 |
307 | Koji 🌍 |
308 | pasindu p konghawaththa 🌍 |
309 |
Marcel 📖 |
312 | Ikko Ashimine 📖 |
313 | Nicolas Lepage 🚧 |
314 | Sergey Scat 🌍 |
315 | Mohammed Taha 🌍 |
316 | T. JEGHAM 👀 |
317 | Tarek Touati 👀 |
318 |
Simone Corsi 🌍 |
321 | Anicet Togue 👀 |
322 | Krzysztof Juszcze 📖 |
323 | Hanz 🌍 |
324 | Rafli Surya P 📖 |
325 | Kurt 📖 |
326 | JumperBot_ 📖 |
327 |
2 |
3 |
6 |
7 |
8 |
9 |
45 | 46 | > 您的項目必須足夠穩定,並且擁有一些最低可行功能用以吸引用戶們。 47 | 48 |
49 |54 | 55 | > 挑選一個用戶們能輕易記住的名字。 56 | 57 |
58 |63 | 64 | > 您的訪客們的第一件事就是閱讀您的 README 文檔,所以您得確保它乾淨漂亮、易於閱讀。[這些優秀的 README 文檔可以為您提供參考](https://github.com/matiassingers/awesome-readme)。 65 | 66 |
67 |72 | 73 | > 找出您的項目的強大之處並確保您的訪客們在第一時間了解到它們。 74 | 75 |
76 |81 | 82 | > 訪客們通常希望迅速了解您的項目的目標,它的工作原理以及應該如何使用它。為您的項目提供一個演示或者示例可以很好地滿足訪客們的需求,比如說: 83 | > 84 | > - 利用 GIF 動畫來展示您項目的工作原理 85 | > - 提供一個在線演示的網頁連接 86 | 87 |
88 |93 | 94 | > 您的項目不夠用戶友好可能會造成訪客們的流失。 95 | 96 |
97 |102 | 103 | > 一個優秀的文檔也許是最為重要的一步了。如果您的文檔比較小的話,您可以直接將它包含在 README 文檔裏。否則的話,您或許應該將您的文檔托管在一個獨立的網站上面。一些開源項目比如 [vuepress](https://v1.vuepress.vuejs.org) 可以幫助您非常容易地創建乾淨整潔的文檔。 104 | 105 |
106 |117 | 118 | > 許多訪客會在考慮使用項目之前,先查看項目獲得過得 star 數量。隻需要一些 star 就能讓您的項目比沒有任何 star 的項目更加值得信賴,這就是為什麼您應該在社交網絡上公開宣布之前,請您認識的人支持您的項目。 119 | 120 |
121 |126 | 127 | > 向世界展示您無與倫比的作品!您可以在以下社交媒體和專業平台上發布: 128 | > 129 | > - [Twitter](https://twitter.com) 130 | > - [Linkedin](https://www.linkedin.com/) 131 | > - [Facebook](https://www.facebook.com/) 132 | > - [Reddit](https://www.reddit.com/) 133 | > - [Dev.to](https://dev.to/) 134 | > - [Lobsters](https://lobste.rs/) 135 | > - [Hacker News](https://news.ycombinator.com/) 136 | > - [Product Hunt](https://www.producthunt.com/) 137 | > - [Beta page](https://betapage.co/) 138 | > - [Human Coders](https://news.humancoders.com/) 139 | 140 |
141 |146 | 147 | > 為您的項目寫一些關於您項目的文章。您可以在其中分享您使用到的技術棧、您項目的工作原理和您遇到過得問題等等。然後把這些文章發布在這些平台上: 148 | > 149 | > - [medium](https://medium.com/) 150 | > - [dev.to](https://dev.to/) 151 | 152 |
153 |158 | 159 | > 在正式會議或線下聚會上介紹您的項目是提高知名度的好辦法。 160 | 161 |
162 |167 | 168 | > 雖然錄製視頻並不輕鬆,但它也許是能讓您的項目出名的最有效的辦法。 169 | 170 |
171 |176 | 177 | > 不要在假期或者周末發布您的項目。通常最適合在社交網絡上發布的時間是一周裏中間的那幾天。 178 | 179 |
180 |185 | 186 | > 不要在相同的平台上發布兩次。這將會被視為過度的宣傳,並且有可能為您的項目招致負面宣傳。 187 | 188 |
189 |200 | 201 | > 維護並且改進您的項目,比如:新版本的發布和撰寫變更記錄。 202 | 203 |
204 |209 | 210 | > 別讓 issue 一直處於未解決的狀態並且對此毫無回應。對那些花費自己時間提交 issue 的用戶們好一點。 😉 211 | 212 |
213 |218 | 219 | > 一個健康的項目通常擁有一個社區和許多貢獻者們。在一些 issue 上標注`contribution welcome`標簽或者`good first issue`標簽來讓您的用戶們知道您需要幫助。[關於 github 標簽](https://help.github.com/en/articles/about-labels)。 220 | 221 |
222 |227 | 228 | > 為那些幫助過您的人們鼓掌喝彩! 一些開源項目像是[gatsby](https://github.com/gatsbyjs/gatsby)會獎勵貢獻者們一些小禮物。如果您負擔不起,也可以在 twitter 或者其它平台上發布一封關於項目貢獻的公開感謝信,並且提及那些貢獻者們([公開感謝信的示例](https://twitter.com/FranckAbgrall/status/1139470547492978688))。在您的 README 文檔裏開設一個`貢獻者`欄,以此公開地感謝貢獻者們。或者您也可以在項目文檔或網站上展示您的貢獻者們。以下是一些示例: 229 | > 230 | > - [vuepress (在 README 中的貢獻者欄)](https://github.com/vuejs/vuepress#code-contributors) 231 | > - [Rythm.js (在展示頁面上隨機顯示貢獻者)](https://okazari.github.io/Rythm.js/) 232 | 233 |
234 |239 | 240 | > Github 的 issue 並不一定是和您的用戶溝通最好的地方。如果有需要的話,您可以使用一些聊天平台來和他們討論: 241 | > 242 | > - [Discord](https://discord.com) 243 | > - [Slack](https://slack.com) 244 | > - [Gitter](https://gitter.im/) 245 | 246 |
247 |252 | 253 | > 用戶反饋是改進您項目的最佳方法,他們也許有著能使您的項目變得更好的想法和主意。 254 | 255 |
256 |261 | 262 | > 如果訪問者們能夠見到具體的用例和成功案例的話,他們會更加信任您的項目,比如 [the vuepress gallery](https://vuepress.gallery/)。 263 | 264 |
265 |Franck Abgrall 📖 |
285 | Thomas Betous 📖 |
286 | Eric Briand 📖 |
287 | Faustine Godbillot 📖 |
288 | Benjamin Plouzennec 📖 |
289 | Johan Bonneau 📖 |
290 | Benjamin Petetot 📖 |
291 |
NickHatBoecker 🌍 |
294 | Claire Martinez 🌍 |
295 | André Gama 📖 |
296 | Mathias Bernardeau 📖 |
297 | Antoine Oili 📖 |
298 | Oswld TC 🌍 |
299 | Zhiyue Yi 🌍 |
300 |
Ali khalili 🌍 |
303 | Niusha Pakseresht 🌍 |
304 | David Da Silva 🌍 |
305 | Umut Işık 🌍 |
306 | Alex Castells 🌍 |
307 | Koji 🌍 |
308 | pasindu p konghawaththa 🌍 |
309 |
Marcel 📖 |
312 | Ikko Ashimine 📖 |
313 | Nicolas Lepage 🚧 |
314 | Sergey Scat 🌍 |
315 | Mohammed Taha 🌍 |
316 | T. JEGHAM 👀 |
317 | Tarek Touati 👀 |
318 |
Simone Corsi 🌍 |
321 | Anicet Togue 👀 |
322 | Krzysztof Juszcze 📖 |
323 | Hanz 🌍 |
324 | Rafli Surya P 📖 |
325 | Kurt 📖 |
326 | JumperBot_ 📖 |
327 |
2 |
3 |
6 |
7 |
8 |
9 |
45 | 46 | > ユーザーを惹きつけるために、あなたのプロジェクトが十分に安定していて、かつ最低限の機能を備えている必要があります。 47 | 48 |
49 |54 | 55 | > ユーザーにとって分かりやすい名前を選びましょう。 56 | 57 |
58 |63 | 64 | > READMEはあなたの訪問者が最初に目にするものです。 シンプルできれいで読みやすいものにしましょう。 [リストのREADMEを参考にしてみて下さい](https://github.com/matiassingers/awesome-readme). 65 | 66 |
67 |72 | 73 | > あなたのプロジェクトの強みを明確にし、訪問者に最初に見てもらえるようにしましょう。 74 | 75 |
76 |81 | 82 | > 訪問者はあなたのプロジェクトの目的やV仕組み、使い方をすぐ理解したいと思うでしょう。 デモを提供することはユーザーも満足させるための最良の方法です。それは下記のようなものになるでしょう: 83 | > 84 | > - あなたのプロジェクトの仕組みを示すアニメーションGIF 85 | > - ライブデモへのリンク 86 | 87 |
88 |93 | 94 | > あなたのプロジェクトがユーザーフレンドリー出なければ、あなたの訪問者は減るでしょう。 95 | 96 |
97 |102 | 103 | > 良いドキュメントを作成することは恐らくもっとも重要のステップです。 小さなドキュメントがあれば、READMEの中に含めることもできます。それ以外の場合は、別のウェブサイトにドキュメントをホストするのが良いでしょう。 [vuepress](https://v1.vuepress.vuejs.org)のようないくつかのオープンソースプロジェクトは 簡潔な方法できれいなドキュメントを作成するのに役立つでしょう。 104 | 105 |
106 |117 | 118 | > ほとんどの訪問者が使う前にプロジェクトのstarの数を確認します。最低限のstarがあれば、starがないプロジェクトよりもあなたのプロジェクトの信頼度は高くなります。 ソーシャルメディアで公開する前に、知り合いにプロジェクトの応援をお願いする理由はこのためです。 119 | 120 |
121 |126 | 127 | > Tell the World about your awesome work! Publish on social media and specialized platforms: 128 | > 129 | > - [Twitter](https://twitter.com) 130 | > - [Linkedin](https://www.linkedin.com/) 131 | > - [Facebook](https://www.facebook.com/) 132 | > - [Reddit](https://www.reddit.com/) 133 | > - [Dev.to](https://dev.to/) 134 | > - [Lobsters](https://lobste.rs/) 135 | > - [Hacker News](https://news.ycombinator.com/) 136 | > - [Product Hunt](https://www.producthunt.com/) 137 | > - [Beta page](https://betapage.co/) 138 | > - [Human Coders](https://news.humancoders.com/) 139 | 140 |
141 |146 | 147 | > あなたのプロジェクトについての記事を書きましょう。 目的は、使用した技術スタック、プロジェクトがどのように機能するか、遭遇した問題などです。 下記のプラットフォームに投稿してみましょう: 148 | > 149 | > - [medium](https://medium.com/) 150 | > - [dev.to](https://dev.to/) 151 | 152 |
153 |158 | 159 | > カンファレンスやミートアップでプロジェクトを発表することは、知名度を向上させる良い方法です。 160 | 161 |
162 |167 | 168 | > ビデオを録画することは簡単なことではありません。しかし、それはおそらくあなたのプロジェクトを有名にするための最も効率的な方法です。 169 | 170 |
171 |176 | 177 | > 休日の期間や週末に公開は避けましょう。通常、ソーシャルネットワークで公開するのにベストな時間帯は週の半ばです。 178 | 179 |
180 |185 | 186 | > 同じプラットフォームで2回掲載することはやめましょう。 スパムとみなされ、あなたのプロジェクトの悪評を招くおそれがあります。 187 | 188 |
189 |200 | 201 | > 新しいリリースでプロジェクトを維持・改善し、変更ログを作成しましょう。 202 | 203 |
204 |209 | 210 | > レスポンスのないまま、開いた課題を放置するのはやめましょう。課題を開くのに時間がかかった人には親切にしましょう 😉。 211 | 212 |
213 |218 | 219 | > 健全なプロジェクトとは、コミュニティとコントリビュータがいるプロジェクトのことです。 いくつかの課題に `contribution welcome` や `good first issue` のラベルを付けて、あなたが助けを必要としていることをユーザに知らせましょう。 [ラベルについて](https://help.github.com/en/articles/about-labels). 220 | 221 |
222 |227 | 228 | > 助けてくれた人とは仲良くしましょう! [gatsby](https://github.com/gatsbyjs/gatsby)のようないくつかのオープンプロジェクトでは、コントリビュータにグッズをプレゼントしています。 そんな余裕がないのであれば、(twitter その他のプラットフォームで)貢献に投稿をして、作者に言及しましょう([御礼の見本](https://twitter.com/FranckAbgrall/status/1139470547492978688))。 READMEの中で `Contributors` セクションを設けて、彼らに感謝の意を表したり、プロジェクトのドキュメントやウェブサイトで紹介してみましょう。以下にいくつかの例を示します: 229 | > 230 | > - [vuepress (contributors README section)](https://github.com/vuejs/vuepress#code-contributors) 231 | > - [Rythm.js (random highlighted contributor on demo page)](https://okazari.github.io/Rythm.js/) 232 | 233 |
234 |239 | 240 | > Githubのissuesは、ユーザーとのコミュニケーションをとるための最良の方法とは限りません。. 必要に応じて、チャットプラットフォームを利用して議論をすることができます: 241 | > 242 | > - [Discord](https://discord.com) 243 | > - [Slack](https://slack.com) 244 | > - [Gitter](https://gitter.im/) 245 | 246 |
247 |252 | 253 | > ユーザーフィードバックは、プロジェクトを改善するための最良の方法です。 彼らはおそらく、あなたのプロジェクトをより良いものにするための機能やアイデアを持っています。 254 | 255 |
256 |261 | 262 | > 訪問者は、具体的なユースケースや成功事例を見れば、あなたのプロジェクトを信頼してくれるでしょう。例 [the vuepress gallery](https://vuepress.gallery/). 263 | 264 |
265 |Franck Abgrall 📖 |
285 | Thomas Betous 📖 |
286 | Eric Briand 📖 |
287 | Faustine Godbillot 📖 |
288 | Benjamin Plouzennec 📖 |
289 | Johan Bonneau 📖 |
290 | Benjamin Petetot 📖 |
291 |
NickHatBoecker 🌍 |
294 | Claire Martinez 🌍 |
295 | André Gama 📖 |
296 | Mathias Bernardeau 📖 |
297 | Antoine Oili 📖 |
298 | Oswld TC 🌍 |
299 | Zhiyue Yi 🌍 |
300 |
Ali khalili 🌍 |
303 | Niusha Pakseresht 🌍 |
304 | David Da Silva 🌍 |
305 | Umut Işık 🌍 |
306 | Alex Castells 🌍 |
307 | Koji 🌍 |
308 | pasindu p konghawaththa 🌍 |
309 |
Marcel 📖 |
312 | Ikko Ashimine 📖 |
313 | Nicolas Lepage 🚧 |
314 | Sergey Scat 🌍 |
315 | Mohammed Taha 🌍 |
316 | T. JEGHAM 👀 |
317 | Tarek Touati 👀 |
318 |
Simone Corsi 🌍 |
321 | Anicet Togue 👀 |
322 | Krzysztof Juszcze 📖 |
323 | Hanz 🌍 |
324 | Rafli Surya P 📖 |
325 | Kurt 📖 |
326 | JumperBot_ 📖 |
327 |
3 |
4 |
7 |
8 |
9 |
10 |
46 | 47 | > يجب أن يكون المشروع/البرنامج مستقرًا بدرجة كافية حتى لا يواجه المستخدمون مشكلة في استخدامه! 48 | 49 |
50 |55 | 56 | > اختر اسمًا للتطبيق يمكن للمستخدمين تذكره بسهولة 57 | 58 |
59 |64 | 65 | > ملف README هو أول ما يراه الزائرون ، لذا اجعله بسيطًا وجميلًا وسهل القراءة، [إليك قائمة بأمثلة README](https://github.com/matiassingers/awesome-readme). 66 | 67 |
68 |73 | 74 | > حدد نقاط قوة المشروع و وضحها للزوار 75 | 76 |
77 |82 | 83 | > في الزيارة الأولى ، قد لا يفهم الزوار كيفية عمل المشروع والغرض منه ، لذا يمكنك عرض مثال توضيحي للبرنامج بالطرق التالية: 84 | > 85 | > - صورة متحركة بتنسيق GIF توضح كيفية عمل مشروعك 86 | > - رابط ينقل الزائر إلى المثال التوضيحي 87 | 88 |
89 |94 | 95 | > من المحتمل أن تفقد الزوار إذا لم يكن مشروعك سهل الاستخدام. 96 | 97 |
98 |103 | 104 | > يعد عمل المستندات من أهم الخطوات. إذا كان لديك وثائق قصيرة لمشروعك ، فيمكنك إتاحتها للجمهور مع ملف README. يمكن أن تساعدك نفس وثائق [vuepress](https://v1.vuepress.vuejs.org) في كتابة وثائق مشروعك بطلاقة وجمال. 105 | 106 |
107 |118 | 119 | > سيتحقق معظم الزوار من عدد النجوم التي يمتلكها المشروع قبل التفكير في استخدامه. يجعل الحد الأدنى من النجوم مشروعك أكثر موثوقية من مشروع بدون نجوم. لهذا السبب يجب أن تطلب من الأشخاص الذين تعرفهم دعم مشروعك قبل إصدار إعلان عام على وسائل التواصل الاجتماعي. 120 | 121 |
122 |127 | 128 | > أخبر العالم عن عملك الرائع! النشر على مواقع التواصل الاجتماعي والمنصات المتخصصة: 129 | > 130 | > - [Twitter](https://twitter.com) 131 | > - [Linkedin](https://www.linkedin.com/) 132 | > - [Facebook](https://www.facebook.com/) 133 | > - [Reddit](https://www.reddit.com/) 134 | > - [Dev.to](https://dev.to/) 135 | > - [Lobsters](https://lobste.rs/) 136 | > - [Hacker News](https://news.ycombinator.com/) 137 | > - [Product Hunt](https://www.producthunt.com/) 138 | > - [Beta page](https://betapage.co/) 139 | > - [Human Coders](https://news.humancoders.com/) 140 | 141 |
142 |147 | 148 | > اكتب مقالاً عن مشروعك. حول كيفية عملِه ، والمشكلات التي ظهرت لك أثناء الإنشاء ، وما إلى ذلك ، يمكنك نشره على المنصات التالية: 149 | > 150 | > - [medium](https://medium.com/) 151 | > - [dev.to](https://dev.to/) 152 | 153 |
154 |159 | 160 | > يعد تقديم مشروعك في المؤتمرات أو اللقاءات طريقة جيدة لتحسين ظهوره. 161 | 162 |
163 |168 | 169 | > تسجيل مقطع فيديو ليس سهلاً. ومع ذلك ، من المحتمل أن تكون الطريقة الأكثر فاعلية لجعل مشروعك مشهورًا. 170 | 171 |
172 |177 | 178 | > لا تنشر خلال فترة الإجازات أو عطلات نهاية الأسبوع. عادةً ما يكون أفضل وقت للنشر على الشبكات الاجتماعية هو منتصف الأسبوع. 179 | 180 |
181 |186 | 187 | > لا تنشر مرتين على نفس المنصة. سيتم اعتباره عشوائيًا وقد يتسبب في دعاية سيئة لمشروعك. 188 | 189 |
190 |201 | 202 | > حافظ على مشروعك وقم بتحسينه بإصدارات جديدة وقم بإنشاء سجلات التغيير. 203 | 204 |
205 |210 | 211 | > لا تدع القضايا المفتوحة دون رد. كن لطيفًا مع الأشخاص الذين استغرقوا وقتًا في فتح القضايا. 😉 212 | 213 |
214 |219 | 220 | > المشروع الصحي هو مشروع مع مجتمع ومساهمين. دع المستخدمين يعرفون أنك بحاجة إلى المساعدة من خلال وضع علامات على بعض المشكلات بعلامات `contribution welcome` أو `good first issue`. [إقرأ المزيد](https://help.github.com/en/articles/about-labels). 221 | 222 |
223 |228 | 229 | > كن لطيفا مع الناس الذين ساعدوك! بعض المشاريع مفتوحة المصدر مثل [gatsby](https://github.com/gatsbyjs/gatsby) تكافئ المساهمين بأشياء جيدة. 230 | إذا كنت لا تستطيع تحمل ذلك ، فافعل منشورًا عامًا (على تويتر أو منصات أخرى) حول المساهمة واذكر المؤلف ([هنا مثال على الشكر العام](https://twitter.com/FranckAbgrall/status/1139470547492978688 )). افتح قسم "المساهمون" في المشروع README لشكرهم علنًا أو عرضهم في وثائق مشروعك أو موقع الويب الخاص بك. وهنا بعض الأمثلة: 231 | > 232 | > - [vuepress (contributors README section)](https://github.com/vuejs/vuepress#code-contributors) 233 | > - [Rythm.js (random highlighted contributor on demo page)](https://okazari.github.io/Rythm.js/) 234 | 235 |
236 |241 | 242 | > لا تعد مشكلات Github دائمًا أفضل طريقة للتواصل مع المستخدمين. إذا لزم الأمر ، يمكنك استخدام منصات الدردشة للمناقشة معهم: 243 | > 244 | > - [Discord](https://discord.com) 245 | > - [Slack](https://slack.com) 246 | > - [Gitter](https://gitter.im/) 247 | 248 |
249 |254 | 255 | > آراء المستخدمين هي أفضل طريقة لتحسين مشروعك. ربما لديهم ميزات وأفكار يمكن أن تجعل مشروعك أفضل. 256 | 257 |
258 |263 | 264 | > سيثق الزوار في مشروعك إذا رأوا حالات استخدام وقصص نجاح ملموسة ، على سبيل المثال ، [the vuepress gallery](https://vuepress.gallery/). 265 | 266 |
267 |Franck Abgrall 📖 |
287 | Thomas Betous 📖 |
288 | Eric Briand 📖 |
289 | Faustine Godbillot 📖 |
290 | Benjamin Plouzennec 📖 |
291 | Johan Bonneau 📖 |
292 | Benjamin Petetot 📖 |
293 |
NickHatBoecker 🌍 |
296 | Claire Martinez 🌍 |
297 | André Gama 📖 |
298 | Mathias Bernardeau 📖 |
299 | Antoine Oili 📖 |
300 | Oswld TC 🌍 |
301 | Zhiyue Yi 🌍 |
302 |
Ali khalili 🌍 |
305 | Niusha Pakseresht 🌍 |
306 | David Da Silva 🌍 |
307 | Umut Işık 🌍 |
308 | Alex Castells 🌍 |
309 | Koji 🌍 |
310 | pasindu p konghawaththa 🌍 |
311 |
Marcel 📖 |
314 | Ikko Ashimine 📖 |
315 | Nicolas Lepage 🚧 |
316 | Sergey Scat 🌍 |
317 | Mohammed Taha 🌍 |
318 | T. JEGHAM 👀 |
319 | Tarek Touati 👀 |
320 |
Simone Corsi 🌍 |
323 | Anicet Togue 👀 |
324 | Krzysztof Juszcze 📖 |
325 | Hanz 🌍 |
326 | Rafli Surya P 📖 |
327 | Kurt 📖 |
328 | JumperBot_ 📖 |
329 |
3 |
4 |
7 |
8 |
9 |
10 |
46 | 47 | > برنامه باید به قدر کافی پایدار باشد تا کاربران مشکلی در استفاده از آن نداشته باشند! 48 | 49 |
50 |55 | 56 | > نامی برای برنامه انتخاب کنید که کاربران به راحتی آن را به خاطر بسپارند 57 | 58 |
59 |64 | 65 | > README اولین چیزی است که بازدیدکنندگان آن را مشاهده میکنند پس آن را ساده زیبا و آسان برای خواندن کنید[اینجا لیستی از نمونه های README موجود است](https://github.com/matiassingers/awesome-readme). 66 | 67 |
68 |73 | 74 | > اطمینان حاصل کنید که نقاط قوت پروژه بیشتر توسط بازدیدکنندکان مشاهده شود 75 | 76 |
77 |82 | 83 | > ممکن است بازدیدکنندگان در بازدید اول نحوه کار و هدف برنامه را متوجه نشوند پس شما میتوانید از راه های زیر یک دمو از برنامه را در معرض نمایش قرار دهید 84 | > 85 | > - یک فایل GIF که نحوه کارکرد برنامه را نمایش میدهد 86 | > - یک لینک که بازدید کننده را به دمو منتقل کند 87 | 88 |
89 | 90 |95 | 96 | > شما احتمالا بسیاری از بازدید کنندگان پروژه را زمانی که برنامه کارا و ساده نباشد از دست خواهید داد! 97 | 98 |
99 |104 | 105 | > ساخت مستندات جزو مهمترین مراحل است. اگر شما یک مستند کوتاه برای پروژه خود دارید میتوانید آن را همراه با فایل README در معرض نمایش عموم قرار دهید. مستنداتی همون[vuepress](https://v1.vuepress.vuejs.org) میتوانند به شما کمک کنند تا مستندات پروژه خود را بسیار روان و زیبا بنویسید. 106 | 107 |
108 |119 | 120 | > بیشتر بازدید کنندگان به میزان ستاره های برنامه شما در شبکه های اجتماعی و فروشگاه ها توجه خواهند کرد. تعداد ستاره های بیشتر برنامه شما را مورد اعتماد تر جلوه میدهد پس از کاربران خود بخواهید از شما در این مورد حمایت کنند! 121 | 122 |
123 |128 | 129 | > درباره کار فوق العاده خود در شبکه های اجتماعی و پلتفرم های اختصاصی مثل ابزار های زیر بگویید: 130 | > 131 | > - [Twitter](https://twitter.com) 132 | > - [Linkedin](https://www.linkedin.com/) 133 | > - [Facebook](https://www.facebook.com/) 134 | > - [Reddit](https://www.reddit.com/) 135 | > - [Dev.to](https://dev.to/) 136 | > - [Lobsters](https://lobste.rs/) 137 | > - [Hacker News](https://news.ycombinator.com/) 138 | > - [Product Hunt](https://www.producthunt.com/) 139 | > - [Beta page](https://betapage.co/) 140 | > - [Human Coders](https://news.humancoders.com/) 141 | 142 |
143 |148 | 149 | > مقاله ای درباره پروژه خود بنویسید. درباره نحوه کار برنامه مشکلاتی که برای شما در حین ساخت به وجود آمده و... شما میتوانید آن را در پلتفرم های زیر منتشر کنید: 150 | > 151 | > - [medium](https://medium.com/) 152 | > - [dev.to](https://dev.to/) 153 | 154 |
155 |160 | 161 | > معرفی پروژه در کنفرانس ها میتواند به شما در افزایش میزان بازدید پروژه کمک کند! 162 | 163 |
164 |169 | 170 | > ضبط ویدیو کار آسانی نیست ولی به مشهور شدن برنامه شما کمک خواهد کرد 171 | 172 |
173 |178 | 179 | > برنامه را در تعطیلات و آخر هفته ها منتشر نکنید این کار باعث کمتر دیده شدن شما میشود آن معمولا این کار را در وسط هفته انجام دهید. 180 | 181 |
182 |187 | 188 | > هرگز دوبار یک تبلیغ را در یک شبکه اجتماعی تکرار نکنید در این صورت اسپم در نظر گرفته شده و نادیده گرفته میشود و تاثیر اجتماعی بدی را برای پروژه شما خواهد گذاشت. 189 | 190 |
191 |202 | 203 | > پروژه خود را بهبود ببخشید و آن را در زمان های مختلف برای کاربران منتشر کنید 204 | 205 |
206 |211 | 212 | > اجازه ندهید issue های باز در github باقی بماند با کاربران خود به خوبی رفتار کنید😉 213 | 214 |
215 |220 | 221 | > یک پروژه خوب و سالم پروژه ای است که با مشارکت ساخته و مشکلات آن قادر به حل شدن توسط افراد دیگر باشد. بگذارید دیگران بدانند شما به کمک آن ها نیاز دارید میتوانید با `contribution welcome` و `good first issue` درخواست های خود را در github متنشر کنید[بیشتر بخوانید](https://help.github.com/en/articles/about-labels). 222 | 223 |
224 |229 | 230 | > خوب بودن با کاربران میتواند به شما کمک کند برخی از پروژه های اوپن سورس مانند [gatsby](https://github.com/gatsbyjs/gatsby) به مشارکت های عمومی جایزه میدهند. اگر قادر به انجام این کار نیستید, یک پست منتشر کنید (در توییتر یا سایر پلتفرم ها) در مورد مشارکت و نویسنده ([یک نمونه سپاسگزاری از مشارکت کننده](https://twitter.com/FranckAbgrall/status/1139470547492978688)). یک قسمت در README پروژه به نام `مشارکت کنندگان` ایجاد کنید و نام آن ها را در آن قید کنید. اینجا نمونه هایی موجود است: 231 | > 232 | > - [vuepress (contributors README section)](https://github.com/vuejs/vuepress#code-contributors) 233 | > - [Rythm.js (random highlighted contributor on demo page)](https://okazari.github.io/Rythm.js/) 234 | 235 |
236 |241 | 242 | > قسمت 'issue' های گیت هاب همیشه محلی برای ثبت بازخورد ها نخواهد بود. شما میتوانید از پلتفرم های زیر برای این کار استفاده کنید! 243 | > 244 | > - [Discord](https://discord.com) 245 | > - [Slack](https://slack.com) 246 | > - [Gitter](https://gitter.im/) 247 | 248 |
249 |254 | 255 | > بازخورد کاربران همیشه بهترین راه برای بهتر سازی و حل مشکلات برنامه خواهد بود پس از آن ها برای مشاکرت کمک بگیرید و از ایده های آن ها استفاده کنید 256 | 257 |
258 |263 | 264 | > بازدیدکنندگان به شما اعتماد بیشتری خواهند داشت اگر نمونه های کار شما را توسط سایر کاربران ببینند [the vuepress gallery](https://vuepress.gallery/)). 265 | 266 |
267 |Franck Abgrall 📖 |
287 | Thomas Betous 📖 |
288 | Eric Briand 📖 |
289 | Faustine Godbillot 📖 |
290 | Benjamin Plouzennec 📖 |
291 | Johan Bonneau 📖 |
292 | Benjamin Petetot 📖 |
293 |
NickHatBoecker 🌍 |
296 | Claire Martinez 🌍 |
297 | André Gama 📖 |
298 | Mathias Bernardeau 📖 |
299 | Antoine Oili 📖 |
300 | Oswld TC 🌍 |
301 | Zhiyue Yi 🌍 |
302 |
Ali khalili 🌍 |
305 | Niusha Pakseresht 🌍 |
306 | David Da Silva 🌍 |
307 | Umut Işık 🌍 |
308 | Alex Castells 🌍 |
309 | Koji 🌍 |
310 | pasindu p konghawaththa 🌍 |
311 |
Marcel 📖 |
314 | Ikko Ashimine 📖 |
315 | Nicolas Lepage 🚧 |
316 | Sergey Scat 🌍 |
317 | Mohammed Taha 🌍 |
318 | T. JEGHAM 👀 |
319 | Tarek Touati 👀 |
320 |
Simone Corsi 🌍 |
323 | Anicet Togue 👀 |
324 | Krzysztof Juszcze 📖 |
325 | Hanz 🌍 |
326 | Rafli Surya P 📖 |
327 | Kurt 📖 |
328 | JumperBot_ 📖 |
329 |
2 |
3 |
6 |
7 |
8 |
9 |
45 | > Projenizin, kullanıcıları çekmesi için minimum güvenilir özelliklere sahip ve yeterince kararlı olmalıdır. 46 |
47 |52 | > Kullanıcıların kolayca hatırlayabileceği bir ad seçin. 53 |
54 |59 | > README, ziyaretçilerinizin göreceği ilk şeydir. Basit, güzel ve okunması kolay hale getirin. [İşte güzel README'lerin bir listesi](https://github.com/matiassingers/awesome-readme). 60 |
61 |66 | > Projenizin güçlü yönlerini belirleyin ve ziyaretçilerin önce onları gördüğünden emin olun. 67 |
68 |73 | > Ziyaretçiler projenizin amacını, nasıl çalıştığını ve nasıl kullanacağını hızlı bir şekilde anlamak isteyeceklerdir. Demo sunmak, kullanıcıları memnun etmenin en iyi yoludur. Bunu aşağıdakiler gibi sağlayabilirsiniz: 74 | > - Projenizin nasıl çalıştığını gösteren animasyonlu bir GIF 75 | > - Bir demo videosuna bağlantı 76 |
77 |82 | > Projeniz kullanıcı dostu değilse muhtemelen ziyaretçileri kaybedersiniz. 83 |
84 |89 | > İyi belgeler oluşturmak muhtemelen en önemli adımdır. Küçük bir belge varsa, bunu README'nize ekleyebilirsiniz. Aksi takdirde, belgelerinizi ayrı bir web sitesinde barındırmanız iyi olabilir. [Vuepress](https://v1.vuepress.vuejs.org) gibi bazı açık kaynaklı projeler belgelerinizi basit bir şekilde oluşturmanıza yardımcı olabilir. 90 |
91 |99 | > Çoğu ziyaretçi, projeyi kullanmayı düşünmeden önce kaç yıldıza sahip olduğunu kontrol edecektir. Minimum miktarda yıldız, projenizi sıfır yıldızlı bir projeden daha güvenilir hale getirir. Bu yüzden sosyal medyada kamuya açık bir duyuru yapmadan önce tanıdığınız insanlara projenizi desteklemelerini istemelisiniz. 100 |
101 |106 | > Dünyaya çalışmalarınızdan bahsedin! Sosyal medyada ve özel platformlarda yayınlayın: 107 | > - [Twitter](https://twitter.com) 108 | > - [Linkedin](https://www.linkedin.com/) 109 | > - [Facebook](https://www.facebook.com/) 110 | > - [Reddit](https://www.reddit.com/) 111 | > - [Dev.to](https://dev.to/) 112 | > - [Lobsters](https://lobste.rs/) 113 | > - [Hacker News](https://news.ycombinator.com/) 114 | > - [Product Hunt](https://www.producthunt.com/) 115 | > - [Beta page](https://betapage.co/) 116 | > - [Human Coders](https://news.humancoders.com/) 117 |
118 |123 | > Projeniz hakkında makaleler yazın. Amaç kullandığınız teknik yığın, projenizin nasıl çalıştığı, karşılaştığınız sorunlar vb. olabilir. Makale yayınlama platformlarına gönderin: 124 | > - [medium](https://medium.com/) 125 | > - [dev.to](https://dev.to/) 126 |
127 |132 | > Projenizi konferanslarda veya buluşmalarda sunmak, görünürlüğünü artırmak için iyi bir yoldur. 133 |
134 |139 | > Video kaydetmek kolay bir egzersiz değildir. Ancak projenizi ünlü yapmanın en etkili yolu muhtemelen budur. 140 |
141 |146 | > Tatil döneminde veya hafta sonlarında yayınlamayın. Genellikle sosyal ağlarda yayınlamak için en uygun zaman hafta ortasıdır. 147 |
148 |153 | > Aynı platformda iki kez yayınlamayın. Spam olarak kabul edilir ve projeniz için kötü tanıtımlara neden olabilir. 154 |
155 |164 | > Projenizi yeni sürümlerle koruyun, geliştirin ve changelog'lar oluşturun. 165 |
166 |171 | > Açılan sorunlarınların yanıtsız kalmasına izin vermeyin. Sorun açmak ya da soru sormak için zaman harcayan insanlara iyi davranın. 😉 172 |
173 |178 | > Sağlıklı bir proje, bir topluluğa ve katkıda bulunanlara sahip bir projedir. Kullanıcılarınıza, `contribution welcome` veya `good first issue` etiketleriyle bazı sorunları etiketleyerek yardıma ihtiyacınız olduğunu bildirin. [Github etiketlerini gözden geçirin](https://help.github.com/en/articles/about-labels). 179 |
180 |185 | > Size yardım eden insanlara iyi davranın! [Gatsby](https://github.com/gatsbyjs/gatsby) gibi bazı açık kaynak projeleri katkıda bulunanları güzelliklerle ödüllendirir. Bunu karşılayamıyorsanız, katkı hakkında kamuya açık bir yayın yapın (twitter veya diğer platformlarda) ve yazardan bahsedin ( [burada açık bir teşekkür örneği var](https://twitter.com/FranckAbgrall/status/1139470547492978688) ). Herkese teşekkür etmek veya proje belgelerinizde veya web sitenizde sergilemek için README'nizde bir `Contributors` bölümü açın. İşte bazı örnekler: 186 | > - [vuepress (README'deki katkıda bulunanlar bölümü)](https://github.com/vuejs/vuepress#code-contributors) 187 | > - [Rythm.js (demo sayfasında rastgele vurgulanan katılımcı)](https://okazari.github.io/Rythm.js/) 188 |
189 |194 | > Github sorunları her zaman kullanıcılarınızla iletişim kurmanın en iyi yolu değildir. Gerekirse, onlarla görüşmek için sohbet platformlarını kullanabilirsiniz: 195 | > - [Discord](https://discord.com) 196 | > - [Slack](https://slack.com) 197 | > - [Gitter](https://gitter.im/) 198 |
199 |204 | > Kullanıcı geri bildirimi, projenizi geliştirmenin en iyi yoludur. Kullanıcılar muhtemelen projenizi daha iyi hale getirebilecek özelliklere ve fikirlere sahiptirler. 205 |
206 |211 | > Ziyaretçiler, somut kullanım örnekleri ve başarı öyküleri (örneğin [vuepress galerisi](https://vuepress.gallery/) ) görürse projenize güveneceklerdir. 212 |
213 |Franck Abgrall 📖 |
232 | Thomas Betous 📖 |
233 | Eric Briand 📖 |
234 | Faustine Godbillot 📖 |
235 | Benjamin Plouzennec 📖 |
236 | Johan Bonneau 📖 |
237 | Benjamin Petetot 📖 |
238 |
NickHatBoecker 🌍 |
241 | Claire Martinez 🌍 |
242 | André Gama 📖 |
243 | Mathias Bernardeau 📖 |
244 | Antoine Oili 📖 |
245 | Oswld TC 🌍 |
246 | Zhiyue Yi 🌍 |
247 |
Ali khalili 🌍 |
250 | Niusha Pakseresht 🌍 |
251 | David Da Silva 🌍 |
252 | Umut Işık 🌍 |
253 | Alex Castells 🌍 |
254 | Koji 🌍 |
255 | pasindu p konghawaththa 🌍 |
256 |
Marcel 📖 |
259 | Ikko Ashimine 📖 |
260 | Nicolas Lepage 🚧 |
261 | Sergey Scat 🌍 |
262 | Mohammed Taha 🌍 |
263 | T. JEGHAM 👀 |
264 | Tarek Touati 👀 |
265 |
Simone Corsi 🌍 |
268 | Anicet Togue 👀 |
269 | Krzysztof Juszcze 📖 |
270 | Hanz 🌍 |
271 | Rafli Surya P 📖 |
272 | Kurt 📖 |
273 | JumperBot_ 📖 |
274 |
2 |
3 |
6 |
7 |
8 |
9 |
45 | 46 | > භාවිතා කරන්නන් ඇදගැනීම සඳහා ඔබගේ ව්යාපෘතිය අඩුම ශක්යතා යටතේ ස්ථාවර විය යුතුය. 47 | 48 |
49 |54 | 55 | > භාවිත කරන්නන්ට පහසුවෙන් මතක තබාගතහැකි නමක් භාවිතා කරන්න. 56 | 57 |
58 |63 | 64 | > නරඹන්නන්ට මුලින්ම දකින්න ලැබෙන්නෙ ඔබගේ README පිටුවයි.එය සරලව,පැහැදිලිව සහ පහසුවෙන් කියවිය හැකි ලෙස තබාගන්න. [ලස්සන README පිටු කිහිපයක්](https://github.com/matiassingers/awesome-readme). 65 | 66 |
67 |72 | 73 | > ඔබගේ ව්යාපෘතියේ වැදගත් තැන් හඳුනාගන්න සහ ඒවා නරඹන්නන්ට පැහැදිලිව පෙන්වීමට වගබලාගන්න. 74 | 75 |
76 |81 | 82 | > නරඹන්නන්ට ඔබගේ ව්යාපෘතියේ අරමුණ හඳුනාගැනීමට සලස්වන්න,කොහොමද ඒක වැඩකරන්නෙ,කොහොමද ඒක පාවිච්චි කරන්නෙ යනාදිය සපයන්න.හඳුන්වාදීමක් සැපයීම එය භාවිත කරන කෙනාට තෘප්තිමත් කරන්න තියන හොඳම ක්රමයක්.මෙවැනි ආකාරයෙන්: 83 | > 84 | > - ඔබගේ ව්යාපෘතිය වැඩකරන හැටි animated GIF එකක් විදියට 85 | > - එහි වැඩකරන පිටපතක සබැඳියක් 86 | 87 |
88 |93 | 94 | > ඔබගේ ව්යාපෘතිය භාවිතා කිරීමට අපහසු එකක්නම් ඔබට එය නරඹන්නන් අඩුවී යා හැකිය. 95 | 96 |
97 |102 | 103 | > ව්යාපෘතිය පැහැදිලි කර පිටුවක් සෑදීම ඉතා වැදගත් පියවරකි.ඔබට ඇත්තේ ඉතා කුඩා පැහැදිලි කිරීමක්නම්,එය ඔබගේ README එකට ඇතුළත් කරන්න.එසේ නොමැතිනම් ඔබ එය වෙනත් වෙබ් අඩවියක දමන්න. [vuepress](https://v1.vuepress.vuejs.org) වැනි සමහර විවෘත පරිශීලක ව්යාපෘති වලින් ඔබට මෙවැනි පිටුවක් සාදාගැනීමට උපකාර කල හැකිය. 104 | 105 |
106 |117 | 118 | > බොහෝ නරඹන්නන් ඔබගේ ව්යාපෘතියට ඇති තරු ගණනින් එය භාවිත කරනවාද යන්න පිළිබඳව සැළකිලිමත් වේ.තරු නැතිවීමට වඩා තරු කිහිපයක් තිබීම එය බලන්නන්ට ඔබගේ ව්යාපෘතිය ගැන බොහෝ විශ්වාසයක් ඇතිවේ.එමනිසා සමාජජාලා වල පැතිරවීමට පෙර කිහිපදෙනෙක්ගෙන් උදව් ලබාගන්න. 119 | 120 |
121 |126 | 127 | > ලෝකයාට ඔබගේ වැඩ ගැන දැනුවත් කරන්න! සමාජජාලා වල සහ විශේෂිත මාධ්යවල බෙදාහරින්න: 128 | > 129 | > - [Twitter](https://twitter.com) 130 | > - [Linkedin](https://www.linkedin.com/) 131 | > - [Facebook](https://www.facebook.com/) 132 | > - [Reddit](https://www.reddit.com/) 133 | > - [Dev.to](https://dev.to/) 134 | > - [Lobsters](https://lobste.rs/) 135 | > - [Hacker News](https://news.ycombinator.com/) 136 | > - [Product Hunt](https://www.producthunt.com/) 137 | > - [Beta page](https://betapage.co/) 138 | > - [Human Coders](https://news.humancoders.com/) 139 | 140 |
141 |146 | 147 | > ඔබ මුහුණ දුන්නු ප්රශ්ණ,භාවිතා කල තාක්ෂනයන්,ඔබගේ ව්යාපෘතිය වැඩ කරන හැටි ආදිය පැහැදිලි කරමින් ලිපි ලියන්න.ලිපි පලකල හැකි මාධ්යයන්: 148 | > 149 | > - [medium](https://medium.com/) 150 | > - [dev.to](https://dev.to/) 151 | 152 |
153 |158 | 159 | > සම්මන්ත්රණ/හමුවීම් ආදියේදී ඔබගේ ව්යාපෘතිය පැහැදිලි කිරීම එය ප්රසිද්ධ කිරීමට හැකි ක්රමයකි. 160 | 161 |
162 |167 | 168 | > වීඩියෝ එකක් පටිගත කිරීම ඉතා අපහසු කාර්යයකි.නමුත්,එය ඔබගේ ව්යාපෘතිය ප්රසිද්ධ කිරීමට ඉතාමත් කාර්යක්ෂම ක්රමයකි. 169 | 170 |
171 |176 | 177 | > නිවාඩු දිනවල හා සති අන්තයේදී එය පතුරවා හරින්න කටයුතු නොකරන්න.ඔබගේ ව්යාපෘතිය පතුරුවා හැරීමට හොඳම වේලාවක් වන්නේ සතියේ මැදයි. 178 | 179 |
180 |185 | 186 | > ඔබගේ ප්රසිද්ධ කිරීම් එකම මාධ්යයක් තුළ දෙවරක් සිදු නොකරන්න.එය ජාලය තුළට අපහසුතාවයක් විය හැකියි.එමනිසා ඔබගේ ව්යාපෘතියට නරක බලපෑමක් ඇතිවිය හැකියි. 187 | 188 |
189 |200 | 201 | > ඔබගේ ව්යාපෘතිය අලුත් දේවල් මගින්,වෙනස් කිරීම් මගින් නිතර නිතර දියුණු කරන්න සහ changelogs සාදන්න. 202 | 203 |
204 |209 | 210 | > පිළිතුරු සපයා නැති issues විවෘතව තබා නොගන්න.issues විවෘත කිරීමට වෙලාව ගන්නා අය සමඟ සහයෝගයෙන් කටයුතු කරන්න. 😉 211 | 212 |
213 |218 | 219 | > හොඳ ව්යාපෘතියක් කියන්නෙ දායකත්වය සපයන්නන් සමඟ වැඩකරන ව්යාපෘතියක්.issues වලට සම්බන්ධ කරමින් භාවිත කරන්නන්ව දැනුවත් කරන්න. `contribution welcome`, `good first issue` වැනි lables යොදාගන්න. [සියලු ලේබල් බලන්න](https://help.github.com/en/articles/about-labels). 220 | 221 |
222 |227 | 228 | > ඔබට සහයෝගය දැක්වූ අය සමඟ හොඳින් කටයුතු කරන්න [gatsby](https://github.com/gatsbyjs/gatsby) වැනි ව්යාපෘති මගින් ඔබට දායකත්වය සැපයූ අයට තිලිණ පිරිනැමිය හැකිය. ඔබට එය දැරිය නොහැකි නම්,පොදු සමාජ ජාලයක ලිපියක් දමන්න(twitter වැනි ) ඔබට උදව් කල අයව සඳහන් කරමින්. ([එවැනි ලිපියකට උදාහරණයක්](https://twitter.com/FranckAbgrall/status/1139470547492978688)). README එක තුළ `Contributors` පිටුවක් විවෘත කර ඔවුන්ට ප්රසිද්ධ ලෙස ස්තූති කරන්න. එයට උදාහරණ කිහිපයක්: 229 | > 230 | > - [vuepress (contributors README section)](https://github.com/vuejs/vuepress#code-contributors) 231 | > - [Rythm.js (random highlighted contributor on demo page)](https://okazari.github.io/Rythm.js/) 232 | 233 |
234 |239 | 240 | > Github issues එකිනෙකා අතර අදහස් හුවමාරු කිරීමට හැමවෙලාවෙම හොඳ ක්රමයක් නෙවෙයි.අත්යාවශ්යනම්,එනිනෙකා අතර තොරතුරු හුවමාරු කිරීමට මාධ්යයක් භාවිතා කරන්න : 241 | > 242 | > - [Discord](https://discord.com) 243 | > - [Slack](https://slack.com) 244 | > - [Gitter](https://gitter.im/) 245 | 246 |
247 |252 | 253 | > භාවිත කරන්නන්ගෙන් අදහස් ලබාගැනීමට ඔබගේ ව්යාපෘතිය දියුණු කරගැනීමට හොඳ ක්රමයකි.ඔවුන් ළඟ හොඳ අදහස් තිබෙන්නට පුලුවන් ඔබගේ ඊළඟ ව්යාපෘතිය දියුණු කරගැනීමට. 254 | 255 |
256 |261 | 262 | > නරඹන්නන් එය දැකීම නිසා ඔබගේ ව්යාපෘතිය ගැන විශ්වාසය ඇතිකර ගැනීමට පටන් ගනීවි. උදාහරණ., [the vuepress gallery](https://vuepress.gallery/). 263 | 264 |
265 |Franck Abgrall 📖 |
285 | Thomas Betous 📖 |
286 | Eric Briand 📖 |
287 | Faustine Godbillot 📖 |
288 | Benjamin Plouzennec 📖 |
289 | Johan Bonneau 📖 |
290 | Benjamin Petetot 📖 |
291 |
NickHatBoecker 🌍 |
294 | Claire Martinez 🌍 |
295 | André Gama 📖 |
296 | Mathias Bernardeau 📖 |
297 | Antoine Oili 📖 |
298 | Oswld TC 🌍 |
299 | Zhiyue Yi 🌍 |
300 |
Ali khalili 🌍 |
303 | Niusha Pakseresht 🌍 |
304 | David Da Silva 🌍 |
305 | Umut Işık 🌍 |
306 | Alex Castells 🌍 |
307 | Koji 🌍 |
308 | pasindu p konghawaththa 🌍 |
309 |
Marcel 📖 |
312 | Ikko Ashimine 📖 |
313 | Nicolas Lepage 🚧 |
314 | Sergey Scat 🌍 |
315 | Mohammed Taha 🌍 |
316 | T. JEGHAM 👀 |
317 | Tarek Touati 👀 |
318 |
Simone Corsi 🌍 |
321 | Anicet Togue 👀 |
322 | Krzysztof Juszcze 📖 |
323 | Hanz 🌍 |
324 | Rafli Surya P 📖 |
325 | Kurt 📖 |
326 | JumperBot_ 📖 |
327 |
2 |
3 |
6 |
7 |
8 |
9 |
45 | 46 | > Your project must be stable enough with the minimum viable features in order to hook users. 47 | 48 |
49 |54 | 55 | > Choose a name that users can easily remember. 56 | 57 |
58 |63 | 64 | > The README is the first thing your visitors will see. Make it simple, pretty and easy to read. [Here is a list of beautiful READMEs](https://github.com/matiassingers/awesome-readme). 65 | 66 |
67 |72 | 73 | > Identify your project's strengths and make sure visitors see them first. 74 | 75 |
76 |81 | 82 | > Visitors will want to quickly understand the purpose of your project, how it works, and how to use it. Providing a demo is the best way to satisfy users. It could be: 83 | > 84 | > - An animated GIF demonstrating how your project works 85 | > - A link to a live demo 86 | 87 |
88 |93 | 94 | > You'll probably lose visitors if your project is not user-friendly. 95 | 96 |
97 |102 | 103 | > Creating a good documentation is probably the most important step. If you have a small documentation, you can include it within your README. Otherwise, you should probably host it in a separate website. Some open source projects like [vuepress](https://v1.vuepress.vuejs.org) can help you with creating a clean documentation in a simple way. 104 | 105 |
106 |117 | 118 | > Most visitors will check how many stars the project has before considering using it. A minimum amount of stars makes your project more trustable than a project with zero star. This is why you should ask people you know to support your project before doing a public announcement on social media. 119 | 120 |
121 |126 | 127 | > Tell the World about your awesome work! Publish it on social media and other specialized platforms: 128 | > 129 | > - [Twitter](https://twitter.com) 130 | > - [Linkedin](https://www.linkedin.com/) 131 | > - [Facebook](https://www.facebook.com/) 132 | > - [Reddit](https://www.reddit.com/) 133 | > - [Dev.to](https://dev.to/) 134 | > - [Lobsters](https://lobste.rs/) 135 | > - [Hacker News](https://news.ycombinator.com/) 136 | > - [Product Hunt](https://www.producthunt.com/) 137 | > - [Beta page](https://betapage.co/) 138 | > - [Human Coders](https://news.humancoders.com/) 139 | 140 |
141 |146 | 147 | > Write articles about your project. Purpose can be the technical stack you used, how your project works, problems you encountered, etc. Post it to publishing platforms: 148 | > 149 | > - [medium](https://medium.com/) 150 | > - [dev.to](https://dev.to/) 151 | 152 |
153 |158 | 159 | > Presenting your project at conferences or meetups is a good way to improve its visibility. 160 | 161 |
162 |167 | 168 | > Recording a video is not an easy exercise. However, it's probably the most efficient way to make your project famous. 169 | 170 |
171 |176 | 177 | > Don't publish during holiday periods or weekends. The best time to publish on social networks is usually mid-week. 178 | 179 |
180 |185 | 186 | > Don't publish twice on the same platform. It will be considered as spam and it might cause bad publicity for your project. 187 | 188 |
189 |200 | 201 | > Maintain and improve your project with new releases and generate changelogs. 202 | 203 |
204 |209 | 210 | > Do not let issues stay open without a single response. Be nice with people that took the time to open issues. 😉 211 | 212 |
213 |218 | 219 | > A healthy project is a project with a community and contributors. Let your users know that you need help by tagging some issues with `contribution welcome` or `good first issue` labels. [See github labels](https://help.github.com/en/articles/about-labels). 220 | 221 |
222 |227 | 228 | > Be nice with people that helped you! Some open source projects like [gatsby](https://github.com/gatsbyjs/gatsby) reward contributors with goodies. If you can't afford that, do a public post (on twitter or other platforms) about the contribution and mention the author ([here is an example of public thanks](https://twitter.com/FranckAbgrall/status/1139470547492978688)). Open a `Contributors` section in your README to publicly thank them or showcase them on your project documentation or website. Here are some examples: 229 | > 230 | > - [vuepress (contributors README section)](https://github.com/vuejs/vuepress#code-contributors) 231 | > - [Rythm.js (random highlighted contributor on demo page)](https://okazari.github.io/Rythm.js/) 232 | 233 |
234 |239 | 240 | > Github issues are not always the best way to communicate with your users. If necessary, you can use chat platforms to discuss with them: 241 | > 242 | > - [Discord](https://discord.com) 243 | > - [Slack](https://slack.com) 244 | > - [Gitter](https://gitter.im/) 245 | 246 |
247 |252 | 253 | > User feedback is the best way to improve your project. They probably have features and ideas that could make your project better. 254 | 255 |
256 |261 | 262 | > Visitors will trust your project if they see concrete use cases and success stories, e.g., [the vuepress gallery](https://vuepress.gallery/). 263 | 264 |
265 |Franck Abgrall 📖 |
285 | Thomas Betous 📖 |
286 | Eric Briand 📖 |
287 | Faustine Godbillot 📖 |
288 | Benjamin Plouzennec 📖 |
289 | Johan Bonneau 📖 |
290 | Benjamin Petetot 📖 |
291 |
NickHatBoecker 🌍 |
294 | Claire Martinez 🌍 |
295 | André Gama 📖 |
296 | Mathias Bernardeau 📖 |
297 | Antoine Oili 📖 |
298 | Oswld TC 🌍 |
299 | Zhiyue Yi 🌍 |
300 |
Ali khalili 🌍 |
303 | Niusha Pakseresht 🌍 |
304 | David Da Silva 🌍 |
305 | Umut Işık 🌍 |
306 | Alex Castells 🌍 |
307 | Koji 🌍 |
308 | pasindu p konghawaththa 🌍 |
309 |
Marcel 📖 |
312 | Ikko Ashimine 📖 |
313 | Nicolas Lepage 🚧 |
314 | Sergey Scat 🌍 |
315 | Mohammed Taha 🌍 |
316 | T. JEGHAM 👀 |
317 | Tarek Touati 👀 |
318 |
Simone Corsi 🌍 |
321 | Anicet Togue 👀 |
322 | Krzysztof Juszcze 📖 |
323 | Hanz 🌍 |
324 | Rafli Surya P 📖 |
325 | Kurt 📖 |
326 | JumperBot_ 📖 |
327 |
2 |
3 |
6 |
7 |
8 |
9 |
44 | 45 | > Proyek Anda harus cukup stabil dan memiliki setidaknya fitur yang diperlukan agar dapat menarik perhatian. 46 | 47 |
48 |53 | 54 | > Pilihlah nama yang mudah diingat. 55 | 56 |
57 |62 | 63 | > README adalah yang pertama dilihat oleh pengunjung. Jadikanlah ia sederhana, cantik, dan mudah dibaca. [Inilah koleksi README yang cantik](https://github.com/matiassingers/awesome-readme) 64 | 65 |
66 |71 | 72 | > Munculkan keunggulan proyekmu dan pastikan pengunjung melihatnya dulu. 73 | 74 |
75 |80 | 81 | > Pengunjung akan cepat menyerap tujuan dari proyek Anda, tentang bagaimana itu berkerja dan bagaimana cara menggunakannya. Memfasilitasi demonstrasi adalah cara terbaik untuk memuaskan pengguna. Contohnya: 82 | > 83 | > - Sebuah animasi GIF yang menjelaskan cara kerja proyekmu 84 | > - Tautan kepada demonstrasi yang interaktif 85 | 86 |
87 |92 | 93 | > Anda akan kehilangan pengguna jika proyek Anda sulit digunakan. 94 | 95 |
96 |101 | 102 | > Membuat panduan manual yang berkualitas pastinya adalah langkah yang penting. Jika Anda hanya mempunyai panduan kecil, Anda dapat menyelipkannya ke README. Sebaliknya, Anda dapat menyimpannya di laman terpisah. Beberapa proyek open source seperti [vuepress](https://v1.vuepress.vuejs.org) dapat membantu Anda membuat panduan manual dengan mudah. 103 | 104 |
105 |116 | 117 | > Biasanya, pengunjung akan melihat banyaknya "Stars" yang proyek Anda punya sebelum mengambil keputusan. Setidaknya, beberapa "Stars" dapat membuat proyek Anda lebih dapat dipercaya ketimbang proyek yang memiliki 0 "Stars". Itulah mengapa Anda harus mengajak orang terdekat untuk membantu Anda. 118 | 119 |
120 |125 | 126 | > Beritahukan kepada dunia mengenai produkmu! Publikasikan ke salah satu dari yang dibawah: 127 | > 128 | > - [Twitter](https://twitter.com) 129 | > - [Linkedin](https://www.linkedin.com/) 130 | > - [Facebook](https://www.facebook.com/) 131 | > - [Reddit](https://www.reddit.com/) 132 | > - [Dev.to](https://dev.to/) 133 | > - [Lobsters](https://lobste.rs/) 134 | > - [Hacker News](https://news.ycombinator.com/) 135 | > - [Product Hunt](https://www.producthunt.com/) 136 | > - [Beta page](https://betapage.co/) 137 | > - [Human Coders](https://news.humancoders.com/) 138 | 139 |
140 |145 | 146 | > Tulis artikel tentang proyekmu. Isi artikel dapat menjelaskan mengenai _stack_ yang digunakan, bagaimana cara proyekmu bekerja, masalah apa yang anda temukan, dsb. Lalu publikasikan artikel ke media publikasi seperti: 147 | > 148 | > - [medium](https://medium.com/) 149 | > - [dev.to](https://dev.to/) 150 | 151 |
152 |157 | 158 | > Dengan mempresentasikan proyekmu didepan umum, proyekmu akan dapat lebih banyak perhatian. 159 | 160 |
161 |166 | 167 | > Merekam video bukanlah sesuatu yang mudah. Tapi, itu adalah metode yang paling efektif untuk membuat proyekmu terkenal. 168 | 169 |
170 |175 | 176 | > Jangan publikasikan ketika musim liburan atau akhir pekan. Biasanya, waktu yang tepat adalah ditengah minggu. 177 | 178 |
179 |184 | 185 | > Jangan mempublikasi dua kali ke media yang sama. Itu akan dideteksi sebagai spam dan mengurangi reputasi proyekmu. 186 | 187 |
188 |199 | 200 | > Jaga dan tingkatkan proyek Anda dengan versi baru dan riwayat pergantian. 201 | 202 |
203 |208 | 209 | > Jangan biarkan satupun isu tanpa respon. Berbaik hatilah kepada orang yang membuka isu tersebut. 😉 210 | 211 |
212 |217 | 218 | > Proyek yang berkualitas adalah proyek dengan komunitas dan kontributor yang aktif. Jadikan penggunamu tahu bahwa anda butuh bantuan dengan melabelkan isu-isu dengan label `contribution welcome` atau `good first issue`. [Lihat github labels](https://help.github.com/en/articles/about-labels). 219 | 220 |
221 |226 | 227 | > Jadilah baik dengan orang-orang yang membantumu! Beberapa proyek seperti [gatsby](https://github.com/gatsbyjs/gatsby) memberikan hadiah keren kepada kontributor seperti kaos. Jika Anda tidak dapat mengikuti metode tersebut, Anda dapat memberikan kata terima kasih lewat media sosial ([ini contohnya](https://twitter.com/FranckAbgrall/status/1139470547492978688)). Buka bagian `Contributors` di README untuk memberikan kata terima kasih atau tampilkan mereka di panduan manual proyekmu. Berikut beberapa contohnya: 228 | > 229 | > - [vuepress (bagian kontributor di README)](https://github.com/vuejs/vuepress#code-contributors) 230 | > - [Rythm.js (kontributor secara acak di tampilkan di halamn demo)](https://okazari.github.io/Rythm.js/) 231 | 232 |
233 |238 | 239 | > GitHub Issues bukanlah yang terbaik dalam berkomunikasi dengan penggunamu. Jika perlu, Anda dapat menggunakan media komunikasi untuk berdiskusi dengan mereka: 240 | > 241 | > - [Discord](https://discord.com) 242 | > - [Slack](https://slack.com) 243 | > - [Gitter](https://gitter.im/) 244 | 245 |
246 |251 | 252 | > Saran dari pengguna adalah jalan yang terbaik dalam memperbaiki proyek Anda. Mereka kemungkinan besar memiliki ide untuk fitur yang dapat meningkatkan kualitas proyek Anda. 253 | 254 |
255 |260 | 261 | > Pendatang akan percaya dengan proyek Anda jika mereka melihat studi kasus yang lengkap dan cerita sukses, contohnya, [The Vuepress Gallery](https://vuepress.gallery/). 262 | 263 |
264 |Franck Abgrall 📖 |
284 | Thomas Betous 📖 |
285 | Eric Briand 📖 |
286 | Faustine Godbillot 📖 |
287 | Benjamin Plouzennec 📖 |
288 | Johan Bonneau 📖 |
289 | Benjamin Petetot 📖 |
290 |
NickHatBoecker 🌍 |
293 | Claire Martinez 🌍 |
294 | André Gama 📖 |
295 | Mathias Bernardeau 📖 |
296 | Antoine Oili 📖 |
297 | Oswld TC 🌍 |
298 | Zhiyue Yi 🌍 |
299 |
Ali khalili 🌍 |
302 | Niusha Pakseresht 🌍 |
303 | David Da Silva 🌍 |
304 | Umut Işık 🌍 |
305 | Alex Castells 🌍 |
306 | Koji 🌍 |
307 | pasindu p konghawaththa 🌍 |
308 |
Marcel 📖 |
311 | Ikko Ashimine 📖 |
312 | Nicolas Lepage 🚧 |
313 | Sergey Scat 🌍 |
314 | Mohammed Taha 🌍 |
315 | T. JEGHAM 👀 |
316 | Tarek Touati 👀 |
317 |
Simone Corsi 🌍 |
320 | Anicet Togue 👀 |
321 | Krzysztof Juszcze 📖 |
322 | Hanz 🌍 |
323 | Rafli Surya P 📖 |
324 | Kurt 📖 |
325 | JumperBot_ 📖 |
326 |
2 |
3 |
6 |
7 |
8 |
9 |
43 | 44 | > Dein Projekt muss stabil genug sein mit einem Minimum an brauchbaren Features zu funktionieren, um Nutzer zu begeistern. 45 | 46 |
47 |52 | 53 | > Wähle einen Namen, der leicht zu merken ist. 54 | 55 |
56 |61 | 62 | > Die README ist das erste, was deine Besucher sehen werden. Gestalte sie simpel, schön und gut lesbar. [Hier ist eine List mit schönen READMEs](https://github.com/matiassingers/awesome-readme). 63 | 64 |
65 |70 | 71 | > Bestimme die Stärken deines Projekts und stell sicher, dass Besucher sie als erstes sehen. 72 | 73 |
74 |79 | 80 | > Besucher wollen schnellstmöglich den Sinn deines Projekts verstehen, wie es funktioniert und wie man es benutzt. Mit einer Demo ist das am einfachsten. Eine Demo könnte folgendes sein: 81 | > 82 | > - Ein animiertes GIF, das zeigt, wie dein Projekt funktioniert 83 | > - Ein Link zu einer Live Demo 84 | 85 |
86 |91 | 92 | > Ist dein Projekt nicht nutzerfreundlich, wirst du vermutlich Besucher verlieren. 93 | 94 |
95 |100 | 101 | > Eine gute Dokumentation zu erstellen ist vermutlich der wichtigste Schritt. Eine kurze Dokumentation kannst du in der README anlegen. Andernfalls solltest du sie in eine eigene Webseite einbetten. Diverse Open Source Projekte wie [vuepress](https://v1.vuepress.vuejs.org) können dir dabei helfen, eine saubere Dokumentation zu schreiben. 102 | 103 |
104 |115 | 116 | > Viele Besucher werden die Anzahl der Sterne überprüfen, bevor sie in Erwägung ziehen, das Projekt zu benutzen. Eine kleine Anzahl an Sternen wirkt vertrauenswürdiger als gar keine Sterne. Deshalb solltest du Bekannte fragen, ob sie dein Projekt unterstützen und auf ihren Social Media Kanälen bewerben. 117 | 118 |
119 |124 | 125 | > Erzähl der Welt von deiner tollen Arbeit! Veröffentliche Sie auf Social Media Kanälen und passenden Plattformen: 126 | > 127 | > - [Twitter](https://twitter.com) 128 | > - [Linkedin](https://www.linkedin.com/) 129 | > - [Facebook](https://www.facebook.com/) 130 | > - [Reddit](https://www.reddit.com/) 131 | > - [Dev.to](https://dev.to/) 132 | > - [Lobsters](https://lobste.rs/) 133 | > - [Hacker News](https://news.ycombinator.com/) 134 | > - [Product Hunt](https://www.producthunt.com/) 135 | > - [Beta page](https://betapage.co/) 136 | > - [Human Coders](https://news.humancoders.com/) 137 | 138 |
139 |144 | 145 | > Schreibe Artikel über dein Projekt. Schreib über die technischen Anforderungen, wie dein Projekt funktioniert, Probleme auf die du gestoßen bist, etc. Mögliche Plattformen zum Veröffentlichen: 146 | > 147 | > - [medium](https://medium.com/) 148 | > - [dev.to](https://dev.to/) 149 | 150 |
151 |156 | 157 | > Wenn du dein Projekt auf Konferenzen oder Treffen präsentierst, steigert das dessen Bekanntheitsgrad. 158 | 159 |
160 |165 | 166 | > Ein Video aufzunehmen ist keine einfache Aufgabe. Allerdings ist es wohl der effizienteste Weg, um dein Projekt bekannt zu machen. 167 | 168 |
169 |174 | 175 | > Publiziere nicht während den Ferien oder an Wochenenden. Schreib stattdessen lieber in der Mitte der Woche. 176 | 177 |
178 |183 | 184 | > Publiziere nicht zwei Mal auf der selben Plattform. Das gilt als Spam und könnte schlechtes Licht auf dein Projekt werfen. 185 | 186 |
187 |198 | 199 | > Warte und verbessere dein Projekt mit neuen Releases und veröffentliche Changelogs. 200 | 201 |
202 |207 | 208 | > Lass kein offenes Issue unbeantwortet. Sei nett zu den Leuten, die ein Ticket eröffnet haben. 😉 209 | 210 |
211 |216 | 217 | > Ein gesundes Projekt ist ein Projekt mit einer Community und Mitwirkenden. Lass deine Nutzer wissen, dass du Hilfe brauchst, indem du Tickets mit `contribution welcome` oder `good first issue` betitelst. [Siehe github Labels](https://help.github.com/en/articles/about-labels). 218 | 219 |
220 |225 | 226 | > Sei nett zu Leuten, die dir geholfen haben! Manche Open Source Projekte wie [gatsby](https://github.com/gatsbyjs/gatsby) belohnen Mitwirkende mit Goodies. Wenn du dir das nicht leisten kannst, schreib einen Beitrag (auf Twitter oder anderen Plattformen) und erwähne den Autor ([hier ist ein Beispiel zu einem öffentlichen Dankeschön](https://twitter.com/FranckAbgrall/status/1139470547492978688)). Eröffne einen `Mitwirkende` Bereich in deiner README, um den Leuten öffentlich zu danken. Du kannst diese Namen auch in deiner Dokumentation oder auf deiner Webseite zeigen. Hier sind ein paar Beispiele: 227 | > 228 | > - [vuepress (Mitwirkende in der README)](https://github.com/vuejs/vuepress#code-contributors) 229 | > - [Rythm.js (Zufälliger Mitwirkender auf der Demo Seite)](https://okazari.github.io/Rythm.js/) 230 | 231 |
232 |237 | 238 | > Github Tickets sind nicht immer der beste Weg, um mit deinen Nutzern zu kommunizieren. Falls nötig, kannst du eine Chat Plattform dafür nutzen: 239 | > 240 | > - [Discord](https://discord.com) 241 | > - [Slack](https://slack.com) 242 | > - [Gitter](https://gitter.im/) 243 | 244 |
245 |250 | 251 | > Nutzer-Feedback ist der beste Weg, um dein Projekt zu verbessern. Jemand hat bestimmt einen Wunsch oder eine Idee, um dein Projekt noch besser zu machen. 252 | 253 |
254 |259 | 260 | > Besucher werden deinem Projekt vertrauen, wenn sie konkrete Beispiele sehen, zum Beispiel [the vuepress gallery](https://vuepress.gallery/)). 261 | 262 |
263 |Franck Abgrall 📖 |
283 | Thomas Betous 📖 |
284 | Eric Briand 📖 |
285 | Faustine Godbillot 📖 |
286 | Benjamin Plouzennec 📖 |
287 | Johan Bonneau 📖 |
288 | Benjamin Petetot 📖 |
289 |
NickHatBoecker 🌍 |
292 | Claire Martinez 🌍 |
293 | André Gama 📖 |
294 | Mathias Bernardeau 📖 |
295 | Antoine Oili 📖 |
296 | Oswld TC 🌍 |
297 | Zhiyue Yi 🌍 |
298 |
Ali khalili 🌍 |
301 | Niusha Pakseresht 🌍 |
302 | David Da Silva 🌍 |
303 | Umut Işık 🌍 |
304 | Alex Castells 🌍 |
305 | Koji 🌍 |
306 | pasindu p konghawaththa 🌍 |
307 |
Marcel 📖 |
310 | Ikko Ashimine 📖 |
311 | Nicolas Lepage 🚧 |
312 | Sergey Scat 🌍 |
313 | Mohammed Taha 🌍 |
314 | T. JEGHAM 👀 |
315 | Tarek Touati 👀 |
316 |
Simone Corsi 🌍 |
319 | Anicet Togue 👀 |
320 | Krzysztof Juszcze 📖 |
321 | Hanz 🌍 |
322 | Rafli Surya P 📖 |
323 | Kurt 📖 |
324 | JumperBot_ 📖 |
325 |