Jaminan Versi

Modul ini mengikuti prinsipalitas semantic versioning yang berarti versi major akan diubah setiap ada perubahan yang tidak cocok dengan versi lama. Tapi dikarenakan Discord tidak memberikan jaminan ketika ada perubahan mendadak dan juga Python sendiri yang ribet untuk diurus. Akan susah menentukan mana yang perubahan major dan yang tidak.

Hal yang harus diketahui, perubahan major hanyalah berlaku untuk fungsi dan kelas yang didokumentasikan. Jika tidak ada di dokumentasi maka fungsi atau kelas tersebut bukanlah bagian dari API publik dan dapat berubah sewaktu-waktu. Ini berlaku juga untuk attribut yang diawali dengan garis bawah atau fungsi tanpa garis bawah yang tidak didokumentasikan.

Catatan

Contoh berikut tidak mencakup sepenuhnya.

Contoh perubahan major

• Mengubah parameter default menjadi yang lain.

• Mengubah nama fungsi tanpa membuat alias nama fungsi lama.

• Menambah atau menghapus parameter ke sebuah event.

Contoh perubahan non-major

• Menambah atau menghapus attribute awalan garis bawah.

• Menambah elemen ke data __slots__ pada sebuah kelas.

• Mengubah sesuatu untuk memperbaiki bug atau error.

• Perubahan pada dokumentasi.

• Mengubah penangan internal HTTP.

• Mengubah versi depedencies, maupun yang major atau tidak.