菜单

贡献

相关源文件

本文档提供了如何为 free-programming-books-zh_CN 仓库贡献信息的说明。它概述了贡献流程、提交新资源的指南以及确保此中文免费编程资源集合高质量贡献的最佳实践。

概述

free-programming-books-zh_CN 仓库是一个由社区维护的中文免费编程书籍和资源集合。该仓库依赖社区的贡献来成长和保持更新。任何人都可以通过添加新资源、更新现有资源或报告损坏的链接来贡献。

来源: README.md6-7 README.md16-19

贡献流程

向此仓库贡献的主要方式是通过 GitHub 提交拉取请求 (PR)。这样维护者就可以在您的贡献被合并到主集合之前进行审查。

贡献工作流程

来源: README.md20-22

如何贡献

第一步:Fork 仓库

要开始贡献,您需要将仓库 fork 到您的 GitHub 账户,这将为您提供一个个人副本以进行更改。

第二步:添加或更新资源

添加新资源时,请确保

  1. 确定资源的合适类别
  2. 遵循 README.md 文件的现有格式和结构
  3. 在各自的部分中按字母顺序添加您的资源

第三步:提交拉取请求

完成更改后,提交拉取请求以供审核并可能合并到主仓库。

来源: README.md20

贡献指南

资源标准

添加到此集合的所有资源应

  1. 免费:资源必须免费提供
  2. 中文:内容应为中文或有中文翻译
  3. 与编程相关:资源应与编程、计算机科学或相关技术领域相关
  4. 可访问:资源的链接应有效且可访问

格式要求

添加资源时,请遵循此格式

* <FileRef file-url="https://github.com/justjavac/free-programming-books-zh_CN/blob/2ca0d17c/Resource Title" undefined  file-path="Resource Title">Hii</FileRef> Additional description if needed

例如

* [Git教程](http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000) (本文由 [廖雪峰](http://www.liaoxuefeng.com) 创作,如果觉得本教程对您有帮助,可以去 [iTunes](https://itunes.apple.com/cn/app/git-jiao-cheng/id876420437) 购买)

来源: README.md166-167

资源组织

了解仓库的结构对于将您的资源放置在正确的部分很重要。

来源: README.md32-92

如果您发现一个不再可用的链接,您可以贡献

  1. 提交一个 PR,在损坏的链接后添加 :worried: 表情符号
  2. 如果可能,可以提供一个更新的链接

示例

* [Linux 命令行(中文版)](http://billie66.github.io/TLCL/book/)
* [Linux 构建指南](http://works.jinbuguo.com/lfs/lfs62/index.html)
* [Linux Documentation (中文版)](https://www.gitbook.com/book/tinylab/linux-doc/details) :worried:

来源: README.md22 README.md117

贡献者认可

所有贡献者将在仓库的贡献者列表中得到认可,您可以在 GitHub 贡献者页面 上查看。

来源: README.md24

其他资源

有关如何使用 GitHub 进行贡献的更多信息,您可以参考这些资源

要进一步了解仓库结构,请参阅 资源组织

来源: README.md166-167 README.md180 README.md184

结论

您的贡献有助于使该仓库成为中文程序员和学习者的宝贵资源。通过遵循这些指南,您可以确保该集合保持组织性、高质量和对所有人的有用性。

感谢您考虑为 free-programming-books-zh_CN 仓库做出贡献!