Lompat ke konten
dokumentasi.id
Commit a27b09d
v1
Star11 rb

Kamu membaca versi lama. Halaman ini hanya bisa dibaca.

3.1

Programming Languages

Bagian ## Programming Languages menempati README.md:14-245 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-18). 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-127) dan C++ memuat 8 entri (README.md:36-45), 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-54), Java memuat Java Programming Style Guide tanpa deskripsi (README.md:109-114), dan Rust memuat Rust Style Guide tanpa deskripsi (README.md:205-208). 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-240).

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-45).

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.
Fig. 1: Tiga kanal sumber panduan bahasaBagian 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.

KanalCiri pada entriContoh entri
Resmi proyek bahasadokumen berada di domain proyek bahasa, deskripsi memakai kata Official atau menyebut nama bahasaStyle Guide for Python Code (PEP 8) README.md:184-188; Effective Go README.md:94-99; Coding Conventions milik Kotlin README.md:137-139; The D Style README.md:56-58
Komunitasdeskripsi memuat kata community atau community-drivenThe Clojure Style Guide README.md:47-49; Elixir Styleguide README.md:68-70; The Ruby Style Guide README.md:199-203; Blue Style README.md:133-135; C# Style Guide milik Kodeco README.md:30-34
Korporatnama perusahaan muncul pada judul atau deskripsiAirbnb JavaScript Style Guide README.md:119-121; Databricks Scala Guide README.md:210-215; NYTimes Objective-C Style Guide README.md:161-165; LinkedIn Official Swift Style Guide README.md:222-229
Proyek besarnama proyek atau organisasi besar menjadi pemilik panduanLLVM C++ Coding Standards, Chromium C++ style guide, Webkit C++ Code Style Guidelines, Mozilla C++ Coding style README.md:36-45

Sebaran jumlah entri

Enam subbagian dengan butir terbanyak menentukan bobot bagian ini.

SubbagianJumlah entriBaris
JavaScript10README.md:116-127
C++8README.md:36-45
Swift6README.md:222-229
Go4README.md:94-99
Java4README.md:109-114
Scala4README.md:210-215

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.

SubbagianIsiBaris
JSONsatu entri, Google JSON Style GuideREADME.md:129-131
Markdowntiga entri panduan penulisan MarkdownREADME.md:145-149
.NETtiga entri tentang spesifikasi, keamanan, dan penamaanREADME.md:151-155
XMLsatu entri, Google XML Document Format Style GuideREADME.md:242-244

Jebakan yang perlu diingat

⚠️ Heading Java muncul dua kali. Satu sebagai bahasa di bagian ini (README.md:109-114), satu lagi sebagai platform di bawah ## Platforms (README.md:306-308). Pencarian ### Java mengembalikan dua hasil, dan tabel isi hanya menautkan satu jangkar #programming-languages.

⚠️ .NET diletakkan setelah Markdown dan sebelum Nim (README.md:145-157). Pengurutan mengabaikan tanda titik di depan, sehingga pencarian menurut urutan huruf mentah akan melewatkan subbagian ini.

⚠️ Metova's Swift style guide masih terdaftar meskipun deskripsinya menyebut archived, deprecated 2022 (README.md:222-229). 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-26). Beberapa butir di bagian ini memakai pengecualian tersebut dan berhenti setelah tautan (README.md:205-208).