Repo naming conventions: Tier 1 Guideline
@Honyii ci sta già lavorando.
Dal 29/10/2026.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
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.
- Lingua principale
- HTML
- Stelle
- 2
- Fork
- 0
- Merge medio
- 15h 17m
- PR unite (30g)
- 5
Preparare l'ambiente
Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di Open-MBEE/opensysml.github.io
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 68/100
Open-MBEE/opensysml.github.io#20 · 1 commento ·
-
Difficoltà 3/5 Mezza giornata Idoneità per principianti 35/100
-
Slack: Create a welcoming onboarding and introducing new channelsForse già presa @Honyii l’ha presa 18 giorni fa. Aperta
Difficoltà 4/5 3-5 giorni Idoneità per principianti 44/100
Open-MBEE/opensysml.github.io#14 · 2 commenti · 2 reazioni · 1 assegnatario ·