Keluaran awal dan berperingkat

[kmubiin]

Muat naik fail ke dahan master, kemudian berikan penanda versi di laman keluaran.

Keluaran yang dirancang:

versi	keterangan
0.1	tambah /daftar/awal*.csv
0.2	tambah /docs/index.md /docs/_config.yml
...	tambah /docs/rekaan/contoh.md dan paut dari /docs/index.md
0.3	tambah /docs/rekaan/*.md /daftar/reka/ber*.csv
0.4	pindah /daftar/awal*.csv ke /daftar/reka/awal*.csv
...	tambah /daftar/umum/contoh.csv (sumbangan daripada umum)
...	tambah /daftar/regu/contoh.csv (salinan CSV untuk contoh.md)
0.5	tambah /docs/panduan/*.md
...	kemas kini senarai pautan di /docs/index.md
1.0	tambah /daftar/regu/psat.csv (siap buat sementara)
...	kemas kini /docs/panduan/*.md
...	kemas kini kandungan di /docs/index.md (pengenalan ringkas)
...	selesai tambah semua fail di atas dan tambah nota keluaran

... merujuk pada kemas kini yang termasuk dalam versi di baris sebelumnya

Fail /daftar/awal*.csv adalah berdasarkan terjemah mudah dalam isu-isu sebelum ini semasa perbincangan rangkuman kosa kata dan jenis kamus. Anggap sebagai fail bersejarah.

Fail selebihnya akan disediakan oleh M. Keutamaan akan diberi kepada fail psat.csv.

Tidak dinyatakan di atas adalah fail terjemahan mesin 3k yang akan disediakan oleh A. Fail 3k ini tidak terikat dengan Rancangan Akhir, jadi A boleh muat naik fail tersebut kemudian.

Perincian /docs mungkin akan dibawakan dalam satu lagi isu baru.

Untuk keluaran selepas 1.0, isu baru akan dicipta.

[kmubiin]

Sementara itu, M akan mula kemas kini fail daftar dan dokumentasi di repositori bermula esok (Isnin).

Semakan aktiviti CLI setakat 23 April (Isnin)

$ mkdir daftar
$ nano daftar/awal-2.csv
$ nano daftar/awal-3.csv
$ nano daftar/awal-4.csv
$ git add .
$ git commit -m "Cipta daftar dan fail awal"
[master e20f910] Cipta daftar dan fail awal
 3 files changed, 16 insertions(+)
 create mode 100644 daftar/awal-2.csv
 create mode 100644 daftar/awal-3.csv
 create mode 100644 daftar/awal-4.csv
$ git tag -a 0.1 -m "Keluaran awal"
$ git push origin 0.1
Counting objects: 10, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (7/7), done.
Writing objects: 100% (7/7), 945 bytes | 0 bytes/s, done.
Total 7 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
 * [new tag]         0.1 -> 0.1
$ git push
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
   46253f7..e20f910  master -> master

Semasa menjalankan garis perintah di atas, baru faham bahawa git push origin 0.1 dan git push adalah dua garis perintah yang berlainan. Dengan kata lain, tiada jalan pintas untuk kemas kini commit dan tag sekaligus (selain gunakan && untuk satu baris atau alias tersendiri).

Dua garis perintah yang terakhir rasanya tidak perlu ikut aturan. Boleh lakukan git push dulu ataupun sebaliknya. Aturan garis perintah git commit ..., git push, git tag -a 0.1 ..., git push origin 0.1 mungkin lebih biasa atau teratur.

Pengetahuan git sedikit berkarat, perlu buat ulangkaji.

[kmubiin]

Semakan aktiviti CLI setakat 27 April (Jumaat)

...
$ git tag -a 0.2 -m "Keluaran bersama dokumentasi terhad"
$ git tag
0.1
0.2
$ git push origin 0.2
Counting objects: 1, done.
Writing objects: 100% (1/1), 187 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
 * [new tag]         0.2 -> 0.2

Aktiviti di atas menunjukkan beberapa garis perintah terakhir sahaja.

Selain itu, GitHub Pages bersama Jekyll telah diaktifkan mulai keluaran 0.2 (terbaru hari ini).

• Dua fail dokumentasi telah dimuat naik dan sedia dilayari
• Sebarang contoh daftar, jika ada, ditulis semula dalam jadual berformat Markdown
• Kandungan teks akan ditambah lagi kemudian
• Butang muat turun untuk mendapatkan fail di repositori akan diaktifkan kemudian

Layari https://kmubiin.github.io/suaikata/ (melalui https://github.com/kmubiin/suaikata)

[kmubiin]

Semakan aktiviti CLI setakat petang 28 April (Sabtu)

$ git tag -a 0.3 -m "Keluaran bersama dokumentasi rekaan"
$ git tag
0.1
0.2
0.3
$ git push origin 0.3
Counting objects: 1, done.
Writing objects: 100% (1/1), 188 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
 * [new tag]         0.3 -> 0.3

Aktiviti di atas menunjukkan beberapa garis perintah terakhir sahaja.

Laman utama GitHub Pages tidak akan dikemas kini sehingga semua fail dokumentasi dimuat naik ke repositori. Oleh itu, pautan ke fail dokumentasi yang baru tidak dipaparkan buat masa ini.

[kmubiin]

Semakan aktiviti CLI setakat tengah malam 29 April (Ahad)

$ git tag -a 0.4 -m "Keluaran bersama daftar permulaan"
$ git tag
0.1
0.2
0.3
0.4
$ git push origin 0.4
Counting objects: 1, done.
Writing objects: 100% (1/1), 186 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
 * [new tag]         0.4 -> 0.4
$ git diff 0.3 0.4 --summary
 delete mode 100644 daftar/awal-2.csv
 delete mode 100644 daftar/awal-3.csv
 delete mode 100644 daftar/awal-4.csv
 create mode 100644 daftar/regu/contoh.csv
 create mode 100644 daftar/reka/awal-2.csv
 create mode 100644 daftar/reka/awal-3.csv
 create mode 100644 daftar/reka/awal-4.csv
 create mode 100644 daftar/umum/contoh.csv

Aktiviti di atas menunjukkan beberapa garis perintah terakhir sahaja.

Keluaran ini menyediakan folder untuk hasil daftar yang berbeza: regu, reka, umum.

• Folder regu akan menyimpan semua daftar yang disiapkan oleh dua atau lebih ahli projek.
• Folder reka akan menyimpan rekaan daftar terawal hingga terbaru.
• Folder umum akan menyimpan daftar yang disiapkan oleh pengguna luar atau persendirian.

Keluaran seterusnya mungkin ambil lebih masa sedikit.

[kmubiin]

Semakan aktiviti CLI setakat petang 30 April (Isnin)

$ git tag -a 0.5 -m "Keluaran bersama dokumentasi panduan"
$ git tag
0.1
0.2
0.3
0.4
0.5
$ git push origin 0.5
Counting objects: 1, done.
Writing objects: 100% (1/1), 186 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
 * [new tag]         0.5 -> 0.5
$ git diff 0.4 0.5 --summary 
 create mode 100644 docs/panduan/kamus.md
 create mode 100644 docs/panduan/piawai.md
 create mode 100644 docs/panduan/sumber.md

Aktiviti di atas menunjukkan beberapa garis perintah terakhir sahaja.

Keluaran ini menambah dokumentasi panduan dan melengkapkan bilangan fail dokumentasi yang dirancang (semuanya ada 9 fail untuk panduan dan rekaan). Beberapa fail belum habis ditulis.

Laman utama di GitHub Pages telah dikemas kini dan semua fail dokumentasi boleh dilayari daripada senarai pautan. Satu perenggan teks untuk pengenalan projek akan ditambah kemudian.

Keluaran seterusnya ialah 1.0 dan yang terakhir buat masa ini.

[kmubiin]

Semakan aktiviti CLI terakhir pada 10 Mei (Khamis)

$ git tag -a 1.0 -m "Keluaran siap pertama"
$ git tag
0.1
0.2
0.3
0.4
0.5
1.0
$ git push origin 1.0
Counting objects: 1, done.
Writing objects: 100% (1/1), 180 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To https://github.com/kmubiin/suaikata.git
 * [new tag]         1.0 -> 1.0
$ git diff 0.5 1.0 --summary
 create mode 100644 .gitignore
 create mode 100644 arkib/reka/awal-2.csv
 create mode 100644 arkib/reka/awal-3.csv
 create mode 100644 arkib/reka/awal-4.csv
 create mode 100644 arkib/reka/berasal.csv
 create mode 100644 arkib/reka/beregu-2.3.csv
 create mode 100644 arkib/reka/beregu-2.4.csv
 create mode 100644 arkib/reka/beregu-2.5.csv
 create mode 100644 arkib/reka/beregu-2.6.csv
 create mode 100644 daftar/regu/psat.csv
 delete mode 100644 daftar/reka/awal-2.csv
 delete mode 100644 daftar/reka/awal-3.csv
 delete mode 100644 daftar/reka/awal-4.csv
 delete mode 100644 daftar/reka/berasal.csv
 delete mode 100644 daftar/reka/beregu-2.3.csv
 delete mode 100644 daftar/reka/beregu-2.4.csv
 delete mode 100644 daftar/reka/beregu-2.5.csv
 delete mode 100644 daftar/reka/beregu-2.6.csv
 create mode 100644 daftar/umum/katakerap.csv
 create mode 100644 docs/angka/psat.md
 create mode 100644 docs/lesen.md
 create mode 100644 docs/panduan.md
 create mode 100644 docs/panduan/hak-cipta.md
 create mode 100644 docs/panduan/takrif.md
 create mode 100644 docs/rekaan.md
 create mode 100644 docs/rekaan/helai.md
 create mode 100644 docs/terbitan.md
 create mode 100644 docs/terbitan/1.0.md
 create mode 100644 docs/tinjau.md
 create mode 100644 docs/ulasan/acah.md
 create mode 100644 docs/ulasan/psat.md
$ git diff 0.5 1.0 --stat
 .gitignore                 |   1 +
 arkib/reka/awal-2.csv      |   5 +
 arkib/reka/awal-3.csv      |   5 +
 arkib/reka/awal-4.csv      |   6 +
 arkib/reka/berasal.csv     |   2 +
 arkib/reka/beregu-2.3.csv  |   2 +
 arkib/reka/beregu-2.4.csv  |   2 +
 arkib/reka/beregu-2.5.csv  |   2 +
 arkib/reka/beregu-2.6.csv  |   2 +
 daftar/regu/psat.csv       | 340 ++++++++++++++++++++++++++++++++++++++++++++++
 daftar/reka/awal-2.csv     |   5 -
 daftar/reka/awal-3.csv     |   5 -
 daftar/reka/awal-4.csv     |   6 -
 daftar/reka/berasal.csv    |   2 -
 daftar/reka/beregu-2.3.csv |   2 -
 daftar/reka/beregu-2.4.csv |   2 -
 daftar/reka/beregu-2.5.csv |   2 -
 daftar/reka/beregu-2.6.csv |   2 -
 daftar/umum/katakerap.csv  |   1 +
 docs/angka/psat.md         |  15 ++
 docs/index.md              |  38 ++----
 docs/lesen.md              |  43 ++++++
 docs/panduan.md            |  22 +++
 docs/panduan/asas.md       |  55 +++++++-
 docs/panduan/hak-cipta.md  |  53 ++++++++
 docs/panduan/kamus.md      |  83 +++++++++--
 docs/panduan/piawai.md     |  49 ++++++-
 docs/panduan/sumber.md     |  66 ++++++++-
 docs/panduan/takrif.md     |  62 +++++++++
 docs/rekaan.md             |  22 +++
 docs/rekaan/contoh.md      |   2 +-
 docs/rekaan/helai.md       |  56 ++++++++
 docs/rekaan/kejadian.md    |  19 +--
 docs/rekaan/lajur.md       |  29 ++--
 docs/rekaan/tanda.md       |  28 ++--
 docs/rekaan/warna.md       |  44 +++---
 docs/terbitan.md           |  12 ++
 docs/terbitan/1.0.md       |  17 +++
 docs/tinjau.md             |  20 +++
 docs/ulasan/acah.md        |   6 +
 docs/ulasan/psat.md        |   6 +
 41 files changed, 1000 insertions(+), 141 deletions(-)

Keluaran 1.0 adalah yang terakhir mengikut Rancangan Akhir. Untuk pembaikan keluaran 1.0 dan saki-baki tugas yang tertangguh atau belum selesai, isu baru akan dicipta selepas ini.

Dengan itu, isu ini boleh ditutup dan akhirnya menamatkan Rancangan Akhir.