Repo naming conventions: Tier 1 Guideline

オープン
#17 コメント 0 件 リアクション 0 件 担当者 1 名 GitHub で見る

@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 を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Open-MBEE/opensysml.github.io のほかの issue

Open-MBEE/opensysml.github.io の issue をすべて見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。