Repo naming conventions: Tier 1 Guideline
@Honyii がすでに取り組んでいます。
2026年10月29日 から。
評価
この issue はまだ評価されていません。
説明
This issue is to establish a consistent, descriptive, and maintainable repo naming guideline for higher tiers and the convention should make repo easier to understand and discover while maintaining the project's identity.
Here are general/default rules we can adapt
- Lowercase by default.
- Use lowercase numbers and letters, separated by hyphens. For instance, imagine a project called OpenMBEE Model Manager with three repositories:
| Component | Consistent naming | Inconsistent naming |
|---|---|---|
| Web application | model-manager-web | ModelManager_Web |
| API | model-manager-api | ModelManagerAPI |
| Documentation | model-manager-docs | Model_Manager_Docs |
- Descriptive.
- The name should communicate the project's purpose, product, or component. For instance, imagine a project providing tools for validating SysML models:
| Component | Descriptive naming | Vague naming |
|---|---|---|
| Model validator | sysml-model-validator | project-tool |
| Model examples | sysml-model-examples | examples2 |
| Validation rules | sysml-validation-rules | misc |
- Prefix only when useful.
- Use an established product or architecture prefix where it adds meaningful context. For instance, imagine a product called Flexo MMS with components that belong to that product and a shared utility used across several products:
| Component | Appropriate prefix | Unnecessary or unclear prefix |
|---|---|---|
| Layer 1 service | flexo-mms-layer1-service | openmbee-flexo-mms-layer1-service |
| SysML v2 integration | flexo-mms-sysmlv2 | sysmlv2-integration |
| Shared logging utility | logging-utils | flexo-mms-logging-utils |
The shared utility doesn't need the Flexo MMS prefix if it serves the wider ecosystem rather than that specific product.
- No unnecessary abbreviations.
- Use established domain abbreviations such as SysML, API, and MMS, but avoid obscure shorthand.
| Component | Clear naming | Unclear naming |
|---|---|---|
| Model validator | sysml-model-validator | smv |
| API documentation | model-api-docs | mad |
| Model examples | sysml-model-examples | sme-repo |
The aim isn't to eliminate all abbreviations but to use terms that contributors in the ecosystem will understand.
- Avoid temporary labels.
- Don't use names like new, final, latest, test2, or v2 unless that label is genuinely part of the project's identity.
| Purpose | Appropriate naming | Temporary or confusing naming |
|---|---|---|
| Main integration | sysmlv2-integration | sysmlv2-new |
| Replacement implementation | sysmlv2-integration | sysmlv2-final |
| Automated test suite | sysmlv2-integration-tests | sysmlv2-test2 |
- One naming pattern per component family.
- Related repositories should use consistent ordering of product, component, and role. For instance, imagine a project called Flexo MMS with three components:
| Component | Consistent naming | Inconsistentnaming |
|---|---|---|
| Layer 1 service | flexo-mms-layer1-service | flexo-mms-layer1-service |
| SysML v2 integration | flexo-mms-sysmlv2 | sysmlv2-flexo-integration |
- Preserve established names.
- Existing names can remain where they are recognized, externally referenced, or required by a platform.
- Document exceptions.
- A maintainer or designated repository owner should explain and approve deviations for new Tier 1 repositories.
Action Items for all
- Review the proposed naming rules and examples.
- Discuss whether the proposed repository tiers and their criteria make sense.
- Suggest changes, edge cases, and exceptions based on existing projects and workflows.
- Agree on the default naming format and who approves exceptions.
Action item for me; @Honyii
- [ ] Incorporate feedback and update the policy and examples.
- 主要言語
- HTML
- スター
- 2
- フォーク
- 0
- 平均マージ
- 15時間 17分
- マージ済み PR(30日)
- 5
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
Open-MBEE/opensysml.github.io のほかの issue
-
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
Open-MBEE/opensysml.github.io#20 · コメント 1 件 ·
-
難易度 3/5 半日 初心者へのやさしさ 35/100
-
Slack: Create a welcoming onboarding and introducing new channels対応中かも @Honyii が 18 日前に担当しました。 オープン
難易度 4/5 3〜5日 初心者へのやさしさ 44/100
Open-MBEE/opensysml.github.io#14 · コメント 2 件 · リアクション 2 件 · 担当者 1 名 ·