3.1
Programming Languages
Bagian ## Programming Languages menempati README.md:14-2451 dan menjadi bagian terbesar dalam dokumentasi ini: 43 heading ### berurutan dari Ada sampai XML dengan 101 entri panduan. Setiap subbagian memakai satu nama bahasa sebagai heading, lalu daftar butir bergaya [Title](url) - Description. di bawahnya; subbagian Ada menunjukkan bentuk paling ringkas dengan satu butir (README.md:16-182). Bagian ini berhenti tepat sebelum ## Development Environment, yang dibahas di Development Environment.
Bentuk satu subbagian
Heading subbagian tidak diberi nomor dan tidak bertaut. Jumlah butir per subbagian bervariasi: JavaScript memuat 10 entri (README.md:116-1273) dan C++ memuat 8 entri (README.md:36-454), sedangkan sebagian besar bahasa lain hanya memuat satu sampai tiga entri.
Tidak semua butir memakai deskripsi. Subbagian Common Lisp menutup kedua butirnya tanpa deskripsi (README.md:51-545), Java memuat Java Programming Style Guide tanpa deskripsi (README.md:109-1146), dan Rust memuat Rust Style Guide tanpa deskripsi (README.md:205-2087). Bentuk butir serta urutan abjadnya dijelaskan di Format Entri dan Pengurutan; aturan penambahannya di Proses Kontribusi.
Satu URL memuat sepasang tanda kurung sehingga dibungkus <...>, yaitu Visual Basic Concepts (README.md:237-2408).
Tiga kanal sumber panduan
Setiap subbagian mencampur beberapa asal panduan: dokumentasi resmi proyek bahasa, panduan komunitas, dan panduan milik korporat atau proyek besar lain. Kanal korporat dan proyek besar menumpuk di C++, yang memuat LLVM C++ Coding Standards, Chromium C++ style guide, Webkit C++ Code Style Guidelines, Mozilla C++ Coding style, NASA C++ Coding Standards and Style Guide, dan OceanBase C++ Coding Standards dalam satu subbagian (README.md:36-454).
graph TD
SEC["## Programming Languages: 43 subbagian, 101 entri"] --> OFF["Resmi: dokumentasi proyek bahasa"]
SEC --> COM["Komunitas: panduan gaya komunitas"]
SEC --> ORG["Korporat dan proyek besar"]
OFF --> PEP8["Style Guide for Python Code (PEP 8)"]
OFF --> EFFGO["Effective Go"]
OFF --> KOT["Coding Conventions (Kotlin)"]
OFF --> DSTYLE["The D Style"]
COM --> CLOJ["The Clojure Style Guide"]
COM --> ELIX["Elixir Styleguide"]
COM --> RUBY["The Ruby Style Guide"]
COM --> BLUE["Blue Style (Julia)"]
ORG --> GOOG["Google Python Style Guide"]
ORG --> ABNB["Airbnb JavaScript Style Guide"]
ORG --> DBX["Databricks Scala Guide"]
ORG --> NYT["NYTimes Objective-C Style Guide"]
ORG --> CXX["LLVM, Chromium, WebKit, Mozilla, NASA, OceanBase (C++)"]
style SEC fill:#f59e0b,color:#000
style OFF fill:#2d7d46,color:#fff
style COM fill:#8b5cf6,color:#fff
style ORG fill:#336791,color:#fff
%% fig: Tiga kanal sumber panduan bahasa
%% desc: Bagian Programming Languages memecah 43 subbagian menjadi panduan resmi proyek bahasa, panduan komunitas, dan panduan korporat atau proyek besar.Tabel berikut mengaitkan tiap kanal dengan entri nyata di README.
| Kanal | Ciri pada entri | Contoh entri |
|---|---|---|
| Resmi proyek bahasa | dokumen berada di domain proyek bahasa, deskripsi memakai kata Official atau menyebut nama bahasa | Style Guide for Python Code (PEP 8) README.md:184-1889; Effective Go README.md:94-9910; Coding Conventions milik Kotlin README.md:137-13911; The D Style README.md:56-5812 |
| Komunitas | deskripsi memuat kata community atau community-driven | The Clojure Style Guide README.md:47-4913; Elixir Styleguide README.md:68-7014; The Ruby Style Guide README.md:199-203; Blue Style README.md:133-135; C# Style Guide milik Kodeco README.md:30-34 |
| Korporat | nama perusahaan muncul pada judul atau deskripsi | Airbnb JavaScript Style Guide README.md:119-12118; Databricks Scala Guide README.md:210-21519; NYTimes Objective-C Style Guide README.md:161-16520; LinkedIn Official Swift Style Guide README.md:222-22921 |
| Proyek besar | nama proyek atau organisasi besar menjadi pemilik panduan | LLVM C++ Coding Standards, Chromium C++ style guide, Webkit C++ Code Style Guidelines, Mozilla C++ Coding style README.md:36-454 |
Sebaran jumlah entri
Enam subbagian dengan butir terbanyak menentukan bobot bagian ini.
| Subbagian | Jumlah entri | Baris |
|---|---|---|
| JavaScript | 10 | README.md:116-1273 |
| C++ | 8 | README.md:36-454 |
| Swift | 6 | README.md:222-22921 |
| Go | 4 | README.md:94-9910 |
| Java | 4 | README.md:109-1146 |
| Scala | 4 | README.md:210-21519 |
Enam subbagian tersebut memuat 36 dari 101 entri bagian ini.
Format non-bahasa di dalam bagian bahasa
Bagian ini tidak hanya memuat bahasa pemrograman. JSON, Markdown, .NET, dan XML adalah format atau runtime, tetapi tetap diletakkan di sini.
| Subbagian | Isi | Baris |
|---|---|---|
| JSON | satu entri, Google JSON Style Guide | README.md:129-13122 |
| Markdown | tiga entri panduan penulisan Markdown | README.md:145-14923 |
| .NET | tiga entri tentang spesifikasi, keamanan, dan penamaan | README.md:151-15524 |
| XML | satu entri, Google XML Document Format Style Guide | README.md:242-24425 |
Jebakan yang perlu diingat
⚠️ Heading
Javamuncul dua kali. Satu sebagai bahasa di bagian ini (README.md:109-1146), satu lagi sebagai platform di bawah## Platforms(README.md:306-30826). Pencarian### Javamengembalikan dua hasil, dan tabel isi hanya menautkan satu jangkar#programming-languages.
⚠️
.NETdiletakkan setelahMarkdowndan sebelumNim(README.md:145-15727). Pengurutan mengabaikan tanda titik di depan, sehingga pencarian menurut urutan huruf mentah akan melewatkan subbagian ini.
⚠️
Metova's Swift style guidemasih terdaftar meskipun deskripsinya menyebutarchived, deprecated 2022(README.md:222-22921). Jangan memasukkan tautan ini sebagai rujukan gaya yang berlaku.
⚠️ Aturan kontribusi meminta deskripsi singkat untuk setiap butir, kecuali judulnya sudah cukup jelas (contributing.md:22-2628). Beberapa butir di bagian ini memakai pengecualian tersebut dan berhenti setelah tautan (README.md:205-2087).