3个版本
使用旧的Rust 2015
0.1.2 | 2024年1月17日 |
---|---|
0.1.1 | 2024年1月17日 |
0.1.0 | 2024年1月17日 |
#875 在 开发工具
被 rmtg_server 使用
8KB
rmtg_core
入门
为了使您更容易入门GitLab,以下是一些推荐的下一步操作。
已经是专家?只需编辑此README.md并使其成为您自己的。想要简单? 使用底部模板!
添加您的文件
cd existing_repo
git remote add origin https://gitlab.com/rmtg_workspace/rmtg_core.git
git branch -M main
git push -uf origin main
与您的工具集成
与您的团队协作
测试和部署
使用GitLab内置的持续集成。
- 开始使用GitLab CI/CD
- 使用静态应用安全测试(SAST)分析代码中的已知漏洞
- 使用自动部署将应用程序部署到Kubernetes、Amazon EC2或Amazon ECS
- 使用基于拉取的部署以改进Kubernetes管理
- 设置受保护的环境
编辑此README
准备好将此README变成您自己的,只需编辑此文件并使用下面的方便模板(或者您可以随意组织它 - 这只是一个起点!)。感谢 makeareadme.com 提供此模板。
良好README的建议
每个项目都不同,因此请考虑哪些部分适用于您的项目。模板中使用的部分是大多数开源项目的建议。同时请注意,虽然README可以太长或太详细,但过长总比过短好。如果您认为您的README太长,可以考虑使用另一种形式的文档,而不是删除信息。
名称
为您的项目选择一个自解释的名称。
描述
让人们了解你的项目具体能做什么。提供背景信息,并添加一个链接,以便访问者了解可能不熟悉的参考资料。这里也可以添加特性列表或背景子章节。如果你的项目有替代方案,这里是一个列出不同点的良好位置。
徽章
在一些README中,你可能会看到一些小图像传达元数据,例如项目是否所有测试都通过。你可以在README中使用徽章添加一些。许多服务也有添加徽章的说明。
视觉元素
根据你正在制作的内容,包括截图甚至视频(你通常会看到GIF而不是实际的视频)可能是个好主意。像ttygif这样的工具可以有所帮助,但也可以看看Asciinema,它是一种更复杂的方法。
安装
在特定的生态系统内,可能有安装事物的常见方式,例如使用Yarn、NuGet或Homebrew。然而,考虑到阅读你的README的人可能是一个新手,并希望得到更多指导。列出具体的步骤有助于消除歧义,并尽快让人们开始使用你的项目。如果它只在特定的环境中运行,比如特定的编程语言版本、操作系统或需要手动安装的依赖项,也可以添加一个需求子章节。
使用
广泛使用示例,并在可能的情况下展示预期的输出。如果你能展示最小的使用示例,这将很有帮助,同时如果示例太长,无法合理地包含在README中,也可以提供链接到更复杂的示例。
支持
告诉人们他们可以去哪里寻求帮助。这可能包括问题跟踪器、聊天室、电子邮件地址等。
路线图
如果你对未来的发布有想法,将这些想法列在README中是个好主意。
贡献
说明你是否接受贡献以及接受贡献的要求。
对于想修改你项目的人来说,有一些关于如何开始的文档是有帮助的。可能有一个他们应该运行的脚本或一些需要设置的环境变量。明确这些步骤。这些说明也可能对你未来的自己有用。
你还可以记录代码检查或运行测试的命令。这些步骤有助于确保代码质量高,并减少更改无意中破坏东西的可能性。如果测试需要外部设置,如启动Selenium服务器进行浏览器测试,运行测试的说明尤其有用。
作者和致谢
感谢为项目做出贡献的人。
许可证
对于开源项目,说明它的许可证。
项目状态
如果你已经没有精力或时间继续你的项目,请在README顶部注明开发已放缓或已完全停止。有人可能会选择分支你的项目或自愿担任维护者或所有者,让你的项目继续进行。你还可以明确要求维护者。