Style guides
Style guides
在将文件保存到本地之前,我们使用自动应用某些样式标准. 默认情况下,大多数编辑器/ IDE 都会自动接受设置. 如果您的编辑器/ IDE 不自动支持.editorconfig
,建议您进行调查以查看是否存在插件. 例如,这里是vim的 .
Pre-commit static analysis
强烈建议您安装 ,以便在本地提交之前自动检查静态分析违规.
在您的 GitLab 源目录中运行:
Then before a commit is created, Overcommit will automatically check for RuboCop (and other checks) offenses on every modified file.
这样可以节省您的时间,因为您不必等待配置项检测到相同的错误.
过量提交依赖于预提交钩子,以防止违反其规则集的提交. 如果您想覆盖此行为,可以通过传递 ENV 变量来完成. 即OVERCOMMIT_DISABLE=1 git rebase master
在禁用 Git 钩子的同时进行 rebase.
Ruby, Rails, RSpec
我们的代码库样式由定义和执行.
对于尚未决定的 RuboCop 规则,我们遵循Ruby Style Guide , 和RSpec Style Guide作为编写惯用 Ruby / Rails / RSpec 的通用准则,但是审阅者/维护者应该宽容而不是太宽容关于风格的书呆子.
同样,当前已禁用某些 RuboCop 规则,对于这些规则,审阅者/维护者不得要求作者使用一种或另一种样式,因为这两种样式均被接受. 这不是理想的情况,因为这为留下了空间,并且理想情况下,我们应该启用所有 RuboCop 规则,以避免在评论中进行与样式相关的讨论/挑剔/来回.
此外,我们还有专门的换行样式指南 ,以及专门针对 .
通常,最好通过编程方式执行起毛规则,因为它可以减少前述的自行车脱落 .
为此,我们鼓励在代码库中创建新的 RuboCop 规则.
当创建可以应用于多个应用程序的新警察时,我们建议您将其添加到我们的宝石中.
Database migrations
请参阅专用的《 .
SCSS
请参阅专用的 .
Go
请参阅专用的 .
Shell commands (Ruby)
请参阅的专用准则 .
请参阅专用的 .
Markdown
我们正在遵循 .
Documentation
请参阅专用的 .
Python
请参阅专用的 .