社区贡献

相关源文件

• README.md
• docs/issue-106.md
• docs/issue-28.md
• docs/issue-341.md
• docs/issue-342.md
• docs/issue-343.md
• docs/issue-344.md
• docs/issue-345.md

本页面介绍了社区成员如何为“科技爱好者周刊”做出贡献，包括内容投稿和招聘信息发布流程。关于周刊系统的整体结构，请参阅 周刊系统。

贡献概述

周刊通过 GitHub Issue 接受社区的各种投稿。主要有两个投稿渠道：

1. 内容投稿：为即将发布的周刊推荐文章、软件、工具或资源。
2. 招聘信息：在专门的“谁在招人”帖子中发布招聘机会。

贡献流程图

来源：README.md5-7

内容投稿流程

如需为周刊推荐内容，请遵循以下步骤：

1. 在 ruanyf/weekly 仓库创建一个 GitHub issue。
2. 提供建议的相关信息（链接、描述、为何值得关注）。
3. 编辑将审阅投稿，并选择内容发布在未来的周刊中。
4. 如果被选中，您的投稿将带有适当的署名发布在周刊上。

周刊欢迎推荐第三方内容，也欢迎推广自己的项目和资源，正如仓库 README 中所述：“推荐或自荐文章/软件/资源”。

投稿工作流

来源：README.md5

招聘信息系统

“谁在招人”（Who's Hiring?）板块为发布和发现招聘机会提供了一个平台，尤其是在编程和技术领域。正如仓库 README 所述，这是一项免费为社区提供的服务。

如何使用招聘信息系统

1. 雇主：访问当前的“谁在招人”帖子（可从最新一期周刊或 README 获取链接），然后添加一个新评论，附上招聘详情。
2. 求职者：浏览该帖子以寻找机会。

招聘帖子会定期更新，并会不定期创建新的帖子。当前的招聘信息帖子可以在 README 中链接的 GitHub Issue 中找到。

招聘信息格式

来源：README.md7 docs/issue-106.md7

接受的投稿类型

周刊欢迎各类内容投稿，涵盖多个类别。以下是周刊常规栏目中接受的主要内容类型列表：

类别	描述	示例
文章 (Articles)	信息丰富或引人深思的内容。	博客文章、教程、分析。
工具 (Tools)	开发工具和实用程序。	库、框架、生产力应用程序。
资源 (Resources)	教育性或参考性材料。	网站、课程、文档、开放数据。
软件 (Software)	有用的应用程序。	开源项目、实用程序、应用程序。
资讯 (News)	技术新闻和公告。	行业动态、产品发布。

来源：docs/issue-106.md67-236

社区互动模式

周刊围绕着多个相互关联的渠道运作，形成了一个知识共享和职业社交的生态系统。

来源：README.md1-9 docs/issue-28.md312-319 docs/issue-106.md386-392

贡献指南

为了提高投稿被周刊收录的几率，请考虑以下指南：

1. 相关性：确保投稿内容与技术、编程或数字文化相关。
2. 质量：推荐能为读者提供价值的高质量内容。
3. 时效性：关注相对较新的材料（但也很重视常青内容）。
4. 描述：清晰地说明内容为何值得分享。
5. 署名：包含正确的署名和指向原始来源的链接。

周刊每周五发布，因此请提前提交投稿，以便被考虑纳入即将发布的周刊。

分发渠道

周刊通过多种渠道分发，让订阅者能够以其偏好的格式访问内容：

1. GitHub 仓库：所有往期周刊都存档在 docs/ 目录。
2. 个人博客：在作者的网站上发布。
3. 微信公众号：通过作者的微信渠道分发。

订阅者可以通过以下方式订阅周刊：

• 关注 GitHub 仓库。
• 订阅作者的博客。
• 搜索“阮一峰的网络日志”关注微信公众号，或扫描每期文末提供的二维码。

来源：docs/issue-106.md386-392 docs/issue-341.md392 docs/issue-343.md387-399

搜索历史投稿

仓库中包含大量过往内容。用户可以通过以下方式搜索这些内容：

1. 使用 GitHub 内置的搜索功能。
2. 使用 Sourcegraph.com 进行更高级的搜索。
3. 将仓库克隆到本地，并使用 `grep` 命令搜索内容。

示例搜索命令

来源：README.md9-28

社区贡献的重要性

社区贡献对于周刊的成功至关重要，有助于：

1. 内容和视角的多元化。
2. 发现新兴工具和资源。
3. 连接求职者和就业机会。
4. 促进技术爱好者之间的知识共享。

周刊开放、协作的性质与开源价值观相符，创造了一个知识自由共享的平台，社区成员可以共同贡献智慧并从中受益。