Lompat ke konten
dokumentasi.id
Commit a27b09d
v1
Star11 rb

Kamu membaca versi lama. Halaman ini hanya bisa dibaca.

3.3

Platform

Bagian ## Platforms adalah bagian tingkat dua ketiga di README.md. Heading-nya berada di baris 261 dan diikuti 15 subbagian ###, dari ### Android sampai ### Other (README.md:261). Daftar isi hanya menyebut bagian ini satu kali, sebagai [Platforms](#platforms) di urutan ketiga (README.md:5-12). Tidak ada daftar subbagian di atas, jadi pembaca menavigasi 15 heading itu langsung di badan dokumen.

Setiap subbagian memakai pola yang sama: heading ###, satu baris kosong, lalu daftar butir - [judul](url) - deskripsi, dengan satu baris kosong di antara dua subbagian. Pola dua tingkat inilah yang membuat satu bagian H2 bisa memuat 15 topik berbeda tanpa daftar isi tambahan.

Lima klaster dari 15 subbagian

graph TD
  ROOT["Platforms<br/>15 subbagian"]
  ROOT --> SYS["Sistem dan runtime"]
  ROOT --> VEND["Proyek dan vendor"]
  ROOT --> WEB["Frontend Development"]
  ROOT --> STORE["Data store"]
  ROOT --> UMB["Kategori payung"]
  SYS --> Android["Android"]
  SYS --> Arduino["Arduino"]
  SYS --> Node["Node.js"]
  SYS --> Linux["Linux"]
  VEND --> Apache["Apache"]
  VEND --> GNU["GNU"]
  VEND --> Java["Java"]
  VEND --> Mailchimp["Mailchimp"]
  VEND --> Mozilla["Mozilla"]
  VEND --> Google["Google"]
  WEB --> W1["Markup HTML"]
  WEB --> W2["Stylesheet CSS, Sass, LESS"]
  WEB --> W3["Design system dan checklist"]
  WEB --> W4["Aksesibilitas WCAG 2.1"]
  STORE --> MongoDB["MongoDB"]
  STORE --> SQL["SQL"]
  UMB --> API["API"]
  UMB --> Other["Other"]
  style SYS fill:#2d7d46,color:#fff
  style VEND fill:#2d7d46,color:#fff
  style STORE fill:#336791,color:#fff
  style MongoDB fill:#336791,color:#fff
  style SQL fill:#336791,color:#fff
  style WEB fill:#8b5cf6,color:#fff
  style UMB fill:#f59e0b,color:#000
  style API fill:#f59e0b,color:#000
  style Other fill:#f59e0b,color:#000
%% fig: Peta subbagian Platforms ke topik yang dicakupnya
%% desc: Lima klaster menampung 15 subbagian; hijau menandai sistem, runtime, dan vendor yang benar-benar platform, biru data store, ungu klaster frontend, dan kuning kategori payung yang tidak terikat satu sistem.
Fig. 1: Peta subbagian Platforms ke topik yang dicakupnyaLima klaster menampung 15 subbagian; hijau menandai sistem, runtime, dan vendor yang benar-benar platform, biru data store, ungu klaster frontend, dan kuning kategori payung yang tidak terikat satu sistem.

15 subbagian itu tidak sejenis. Empat di antaranya menyebut sistem atau runtime yang jelas: ### Android memuat dua entri tentang arsitektur dan gaya kode aplikasi Android (README.md:263-266), ### Arduino memuat gaya kode umum dan panduan library (README.md:280-283), ### Node.js memuat pedoman engineering dan gaya kode Node.js (README.md:326-329), dan ### Linux memuat coding style kernel (README.md:310-312).

Enam subbagian lain berupa panduan milik satu proyek atau satu vendor. ### Apache berisi satu entri, panduan gaya bahasa C untuk Apache HTTP Server (README.md:268-270). ### GNU berisi standar kode dan dokumentasi GNU (README.md:302-304). ### Mozilla mengarah ke panduan gaya kode proyek Mozilla (README.md:318-320). ### Google justru panduan editorial dokumentasi developer, bukan gaya kode (README.md:322-324), sedangkan ### Mailchimp panduan gaya konten (README.md:314-316). ### Java di bagian ini hanya memuat JavaEE Specification (README.md:306-308).

Dua subbagian menyimpan bahan data store: ### MongoDB untuk gaya pemakaian MongoDB (README.md:331-333) dan ### SQL untuk gaya serta format SQL (README.md:335-337). Sisanya kategori payung yang tidak terikat satu sistem operasi. ### API memuat lima entri, dari spesifikasi hypermedia HAL sampai API Security Checklist dan Google Cloud API Design Guide (README.md:272-278). ### Other memuat tujuh entri lintas topik seperti changelog, semantic versioning, indentasi, keamanan web, dan CodeQL Coding Standards (README.md:339-347).

Sebaran entri per subbagian

SubbagianBarisEntriTopik utama yang dicakup
### AndroidREADME.md:263-2662arsitektur dan gaya kode aplikasi Android
### ApacheREADME.md:268-2701panduan gaya C untuk Apache HTTP Server
### APIREADME.md:272-2785hypermedia HAL, REST, JSON API, security checklist
### ArduinoREADME.md:280-2832gaya kode umum dan panduan library
### Frontend DevelopmentREADME.md:285-30115HTML, CSS, Sass, LESS, design system, aksesibilitas
### GNUREADME.md:302-3041standar kode dan dokumentasi GNU
### JavaREADME.md:306-3081spesifikasi Java EE
### LinuxREADME.md:310-3121coding style kernel
### MailchimpREADME.md:314-3161panduan gaya konten
### MozillaREADME.md:318-3201panduan gaya kode proyek Mozilla
### GoogleREADME.md:322-3241panduan editorial dokumentasi developer
### Node.jsREADME.md:326-3292pedoman engineering dan gaya kode
### MongoDBREADME.md:331-3331gaya pemakaian MongoDB
### SQLREADME.md:335-3371gaya dan format SQL
### OtherREADME.md:339-3477changelog, semantic versioning, indentasi, keamanan, CodeQL

Sebaran entrinya tidak rata: sembilan subbagian berisi satu entri, tiga berisi dua entri, satu berisi lima, satu berisi tujuh, dan satu berisi 15. Rasio itu menjelaskan mengapa ### Frontend Development terasa seperti katalog tersendiri di dalam bagian ini.

Klaster Frontend Development

### Frontend Development adalah subbagian terbesar: 15 entri berurutan tanpa jeda subjudul (README.md:285-301). Isinya melintasi empat lapis yang di katalog lain biasanya dipisah, yaitu markup HTML, stylesheet CSS dan Sass, bahasa yang dikompilasi menjadi keduanya seperti CoffeeScript dan LESS, serta sistem desain dan checklist pra-rilis.

graph LR
  FE["Frontend Development<br/>15 entri"]
  FE --> SHEET["Stylesheet<br/>CSS Guidelines, Sass Guidelines, Airbnb CSS / Sass, LESS, Google HTML/CSS"]
  FE --> MARKUP["Markup<br/>Frontend Guidelines, HTML Style Guide, HTML + CSS Code Guide"]
  FE --> DESIGN["Design system<br/>U.S. Web Design Standards, Yelp Styleguide"]
  FE --> CHECK["Checklist<br/>Front-End Checklist, Responsive Web Design"]
  FE --> LANG["Lintas bahasa<br/>CoffeeScript Style Guide"]
  FE --> METH["Metodologi<br/>BEM"]
  FE --> A11Y["Aksesibilitas<br/>WCAG 2.1"]
  style SHEET fill:#2d7d46,color:#fff
  style MARKUP fill:#2d7d46,color:#fff
  style CHECK fill:#f59e0b,color:#000
  style METH fill:#8b5cf6,color:#fff
  style A11Y fill:#8b5cf6,color:#fff
%% fig: Isi klaster Frontend Development
%% desc: 15 entri subbagian Frontend Development dikelompokkan menjadi tujuh topik, dari stylesheet dan markup sampai metodologi BEM dan pedoman aksesibilitas WCAG 2.1.
Fig. 2: Isi klaster Frontend Development15 entri subbagian Frontend Development dikelompokkan menjadi tujuh topik, dari stylesheet dan markup sampai metodologi BEM dan pedoman aksesibilitas WCAG 2.1.

Dua entri di blok ini ditulis tanpa deskripsi, yaitu LESS Coding Guidelines dan Google HTML/CSS Style Guide (README.md:285-301). Sisanya mengikuti pola - [judul](url) - deskripsi yang sama seperti bagian lain di README.md, sehingga entri tanpa deskripsi tampil beda dari mayoritas tetangganya.

Titik temu dengan halaman lain dan jebakan format

Heading ### Java muncul dua kali di README.md, di baris 109 dan di baris 306 (README.md:109). Isi keduanya berbeda: yang pertama kumpulan panduan gaya bahasa Java, yang kedua spesifikasi Java EE (README.md:306-308). Pembaca yang membuka anchor #java tidak bisa memastikan bagian mana yang terbuka. Katalog bahasa itu sendiri dibahas di Programming Languages.

Urutan subbagian berjalan alfabetis dari Android sampai Mozilla. ### Google menyimpang karena diletakkan setelah ### Mozilla (README.md:318-320, README.md:322-324), ### MongoDB setelah ### Node.js (README.md:326-329, README.md:331-333), dan ### Other setelah ### SQL (README.md:335-337, README.md:339-347). Aturan pengurutan yang berlaku dibahas di Format Entri dan Pengurutan.

⚠️ Entri Apache Developers' C Language Style Guide di ### Apache adalah panduan sebuah proyek, bukan panduan bahasa (README.md:268-270). Tempatnya di halaman ini, sementara rujukan bahasa C ada di Programming Languages; jangan menyalinnya ke sana.

⚠️ Antara entri terakhir ### Frontend Development dan heading ### GNU tidak ada baris kosong. Baris 301 diakhiri dua spasi, lalu ### GNU langsung menyusul di baris 302 (README.md:285-301, README.md:302-304). Menambah entri di ujung blok itu tanpa baris kosong akan menempelkan heading berikutnya ke butir terakhir.

Jumlah entri tanpa deskripsi di seluruh bagian ini 5 dari 42: dua di ### Frontend Development dan tiga di ### Other (README.md:285-301, README.md:339-347). Frameworks, CMS, dan Tools yang menyusul setelah ## Platforms dibahas di Frameworks, CMS, dan Tools.