Zum Beispiel habe ich einen RESTful-Service namens Purchase Service. Soll ich mein Repository benennen:
purchaserestservice
purchase-rest-service
purchase_rest_service
- oder etwas anderes?
Was ist die Konvention? Wie wäre es in Github? Sollten öffentliche Repositories einem Standard folgen?
git
github
naming-conventions
Adrian M.
quelle
quelle
Antworten:
Ich würde gehen für
purchase-rest-service
. Gründe dafür:Was ist "Kaufaufenthalt"? Lange, verkettete Wörter sind schwer zu verstehen. Ich weiß, ich bin Deutscher. "Donaudampfschifffahrtskapitänspatentausfüllungsassistentenausschreibungsstellenbewerbung."
"_" ist schwerer zu tippen als "-"
quelle
Das Problem mit Kamelfällen ist, dass es häufig unterschiedliche Interpretationen von Wörtern gibt - zum Beispiel checkinService vs checkInService. In Übereinstimmung mit Aarons Antwort ist es bei der automatischen Vervollständigung schwierig, wenn Sie viele ähnlich benannte Repos haben, ständig überprüfen zu müssen, ob die Person, die das Repo erstellt hat, das Ihnen am Herzen liegt, eine bestimmte Aufschlüsselung der Groß- und Kleinbuchstaben verwendet hat. Vermeiden Sie Großbuchstaben.
Sein Punkt über Bindestriche ist ebenfalls gut beraten.
quelle
lowercase-with-hyphens
ist der Stil, den ich am häufigsten auf GitHub sehe. *lowercase_with_underscores
ist wahrscheinlich der zweitbeliebteste Stil, den ich sehe.Ersteres ist meine Präferenz, weil es Tastenanschläge spart.
* Anekdotisch; Ich habe keine Daten gesammelt.
quelle
lowercase-with-hyphens
Denken Sie daran, dass ein Git-Repo in ein beliebiges Stammverzeichnis Ihrer Wahl geklont werden kann, ohne eine bestimmte Namenswahl zu bevorzugen:
Hier
repo.git
würde in die geklont werdenmyDir
Verzeichnis .Selbst wenn Ihre Namenskonvention für ein öffentliches Repo etwas falsch wäre, wäre es dennoch möglich, sie auf der Clientseite zu korrigieren.
Aus diesem Grund gibt es in einer verteilten Umgebung, in der jeder Client tun kann, was er will, keine Namenskonvention für Git Repo.
(außer "
xxx.git
" für die bloße Form des Repos 'xxx
' zu reservieren )Möglicherweise gibt es eine Namenskonvention für den REST-Service (ähnlich wie " Gibt es Richtlinien für Namenskonventionen für REST-APIs? "), aber das ist ein separates Problem.
quelle
Vielleicht wird nur mein Java- und C-Hintergrund angezeigt, aber ich bevorzuge CamelCase (CapCase) gegenüber Interpunktion im Namen. Meine Arbeitsgruppe verwendet solche Namen, wahrscheinlich um mit den Namen der App oder des Dienstes übereinzustimmen, die das Repository enthält.
quelle
Wenn Sie vorhaben , ein PHP-Paket zu erstellen, möchten Sie es höchstwahrscheinlich in Packagist einfügen , um es mit Composer für andere verfügbar zu machen. Der Komponist hat die Namenskonvention as zu verwendende
vendorname/package-name-is-lowercase-with-hyphens
.Wenn Sie ein JS-Paket erstellen möchten, möchten Sie wahrscheinlich npm verwenden. Einer von ihnen Namenskonventionen besteht darin, keine Großbuchstaben in der Mitte Ihres Paketnamens zuzulassen.
Daher würde ich PHP- und JS-Paketen empfehlen,
lowercase-with-hyphens
Ihre Pakete in Composer oder npm identisch mit Ihrem Paket auf GitHub zu verwenden und zu benennen.quelle