Dokumentasi Resmi

Anda telah menempuh seluruh materi Course pandas ini, dari Series pertama sampai pipeline data engineering yang otomatis. Keterampilan yang menentukan kelanjutan perjalanan tersebut bukan menghafal method, melainkan kebiasaan mandiri: mampu menemukan jawaban langsung dari sumber resminya. Chapter ini memandu Anda menjelajah situs pandas.pydata.org dengan peta yang jelas; chapter-chapter berikutnya menuntaskan referensi API, buku, tutorial, dataset, contoh kode, dan glosarium istilah.

Peta Situs pandas.pydata.org #

Situs dokumentasi pandas tersusun sebagai empat gerbang utama yang semuanya bisa diakses dari navigasi atas situs dokumentasi pandas.pydata.org.

Bagian situs	Alamat di bawah `docs/`	Isi utama
Getting started	`getting_started/index.html`	Cara instalasi dan tur singkat untuk pemula
User guide	`user_guide/index.html`	Penjelasan konsep dan fitur, per topik, bab demi bab
API reference	`reference/index.html`	Daftar lengkap fungsi, class, dan method beserta parameternya
What’s New	`whatsnew/v3.0.0.html`	Catatan perubahan resmi pada setiap rilis

Ketika pandas baru terpasang, mulailah dari halaman getting started yang merangkum instalasi dan tur-tur singkat. Setelah itu, user guide menjadi dokumen yang akan Anda buka berulang-ulang, karena setiap topiknya ditulis sebagai bab mandiri. Halaman API reference dibedah pada Chapter Referensi API, sementara What’s New kita bahas di bagian akhir chapter ini.

Halaman User Guide yang Paling Sering Dikunjungi #

Membaca user guide dari depan ke belakang bukan cara yang efisien; simpan daftar halaman inti di bawah ini, lalu buka yang relevan saat topiknya muncul di pekerjaan Anda.

Halaman (`user_guide/`)	Topik yang dibahas
`10min.html`	10 minutes to pandas — tur singkat seluruh alur kerja pandas
`basics.html`	Essential basic functionality — seleksi dasar, dtype, statistik ringkas
`io.html`	IO tools — membaca dan menulis CSV, Excel, JSON, SQL, Parquet
`indexing.html`	Indexing and selecting data — `loc`, `iloc`, boolean masking
`groupby.html`	Group by — pola split-apply-combine dan agregasi
`merging.html`	Merge, join, concatenate — menggabungkan beberapa DataFrame
`reshaping.html`	Reshaping — `pivot`, `melt`, `stack`, `unstack`
`timeseries.html`	Time series / date functionality — datetime index, resampling, offset
`missing_data.html`	Working with missing data — `NaN`, `dropna`, `fillna`, interpolasi

Sembilan halaman di atas mencakup hampir semua section inti Course ini, dari Dasar Series hingga Missing Data Lanjutan; jadikan tabelnya daftar bacaan lanjutan setiap kali satu section selesai.

Dokumentasi yang Ikut Terpasang: Docstring #

Dokumentasi daring membutuhkan internet, tetapi pandas membawa dokumentasi ringkas ke mana pun library terpasang: setiap fungsi menyimpan docstring, teks penjelasan yang bisa dibaca lewat help() atau inspect.getdoc(). Skrip berikut mencetak versi pandas dan kalimat pembuka docstring tiga fungsi kunci.

python

import inspect

import pandas as pd

print("pandas", pd.__version__)
print()

topik = {
    "pd.read_csv (membaca file)": pd.read_csv,
    "pd.DataFrame.groupby (agregasi)": pd.DataFrame.groupby,
    "pd.DataFrame.merge (penggabungan)": pd.DataFrame.merge,
}

for label, obj in topik.items():
    doc = inspect.getdoc(obj) or ""
    baris_pertama = doc.splitlines()[0] if doc else "(tanpa docstring)"
    print(label)
    print(f"  {baris_pertama}")
    print()

Output yang Dihasilkan:

text
pandas 3.0.6

pd.read_csv (membaca file)
  Read a comma-separated values (csv) file into DataFrame.

pd.DataFrame.groupby (agregasi)
  Group DataFrame using a mapper or by a Series of columns.

pd.DataFrame.merge (penggabungan)
  Merge DataFrame or named Series objects with a database-style join.

Mari kita telaah mekanismenya:

Baris 6 (topik = {...}): dictionary memasangkan label berbahasa Indonesia dengan objek fungsi pandas yang asli, bukan string.
Baris 12 (inspect.getdoc(obj)): mengambil docstring objek sebagai satu string panjang; splitlines()[0] mengambil kalimat pertamanya saja.
Baris 13-15: skrip mencetak label, kalimat pembuka docstring, dan baris kosong pemisah.

Docstring adalah bahan yang sama dengan halaman situs: penulis menyusunnya sekali, lalu generator dokumentasi merendernya menjadi halaman API reference. Kalimat Read a comma-separated values (csv) file into DataFrame. pada output di atas persis dengan kalimat pertama halaman pandas.read_csv di situs.

Memantau Perubahan dan Terhubung dengan Komunitas #

Pandas berkembang lewat rilis berkala, dan halaman What’s New untuk v3.0.0 merangkum seluruh perubahan rilis 3.0: string dtype yang kini default, Copy-on-Write yang selalu aktif, sampai method lama yang dihapus. Membaca What’s New sebelum memperbarui versi melindungi kode produksi dari perilaku yang berubah tanpa terduga.

Jika Anda kelak menemukan bug atau ingin menyumbang kode, halaman development dan contributing menjelaskan jalur resminya: melaporkan masalah hingga mengirim pull request. Bagian inilah pusat kegiatan komunitas pandas.

Dokumentasi resmi menjawab pertanyaan “topik apa saja yang ada”. Ketika yang Anda butuhkan adalah daftar parameter lengkap satu method — tanda tangan (signature) resminya — pintu masuk yang lebih cepat adalah API reference pada Chapter berikutnya.