Isu ini akan mengulas dokumentasi untuk projek ini, bermula keluaran 0.2 hingga 1.0 (keluaran semasa yang terakhir bergantung pada keadaan dan mungkin menjadi 1.1 selepas 30 April 2018).
Berikut adalah senarai tugas untuk ciptaan fail-fail dokumentasi.
[x] master: /docs/index.md/docs/_config.yml
[x] master: /docs/panduan/asas.md
[x] master: /docs/panduan/piawai.md
[x] master: /docs/panduan/kamus.md
[x] master: /docs/panduan/sumber.md
[x] master: /docs/rekaan/contoh.md
[x] master: /docs/rekaan/kejadian.md
[x] master: /docs/rekaan/lajur.md
[x] master: /docs/rekaan/tanda.md
[x] master: /docs/rekaan/warna.md
[x] master: /daftar/reka/berasal.csv
[x] master: /daftar/reka/beregu-2.3.csv
[x] master: /daftar/reka/beregu-2.4.csv
[x] master: /daftar/reka/beregu-2.5.csv
[x] master: /daftar/reka/beregu-2.6.csv
Senarai di atas mungkin berubah dan akan dikemas kini dari semasa ke semasa.
Nota 1: Semua rekaan daftar telah dipindahkan ke arkib sejak 6 Mei 2018, yakni fail di /daftar/reka/* sekarang didapati di /arkib/reka/* dalam repositori.
Nota 2: Hanya fail dokumentasi awal disenaraikan dalam isu ini, yakni fail dokumentasi yang dicipta antara tarikh isu ini dicipta dan ditutup (23 hingga 30 April 2018).
26 April 2018: Semua fail dokumentasi akan ditulis dalam format Markdown. Projek ini akan menggunakan GitHub Pages, dan fail dokumentasi lebih baik diterbitkan di dahan gh-pages. Dengan itu, fail lain boleh dikemas kini secara berasingan tanpa menjalankan pembinaan--terhad kepada 10 kali setiap jam menurut dokumen pada masa itu.
26 April 2018 Jam 1648 GMT: Hm, nampaknya saya salah faham... Fungsi butang download di GitHub Pages adalah mengikut dahan sumber yang ditetapkan. Jika dahan gh-pages dipilih sebagai sumber, butang download akan muat turun fail daripada dahan itu sendiri! Sebelum ini, butang download disangka akan muat turun daripada master--bukan rupanya. Kesimpulannya, fail dokumentasi akan dimuat naik ke /docs di dahan master.
Isu ini akan mengulas dokumentasi untuk projek ini, bermula keluaran 0.2 hingga 1.0 (keluaran semasa yang terakhir bergantung pada keadaan dan mungkin menjadi 1.1 selepas 30 April 2018).
Berikut adalah senarai tugas untuk ciptaan fail-fail dokumentasi.
/docs/index.md
/docs/_config.yml
/docs/panduan/asas.md
/docs/panduan/piawai.md
/docs/panduan/kamus.md
/docs/panduan/sumber.md
/docs/rekaan/contoh.md
/docs/rekaan/kejadian.md
/docs/rekaan/lajur.md
/docs/rekaan/tanda.md
/docs/rekaan/warna.md
/daftar/reka/berasal.csv
/daftar/reka/beregu-2.3.csv
/daftar/reka/beregu-2.4.csv
/daftar/reka/beregu-2.5.csv
/daftar/reka/beregu-2.6.csv
Senarai di atas mungkin berubah dan akan dikemas kini dari semasa ke semasa.
Nota 1: Semua rekaan daftar telah dipindahkan ke arkib sejak 6 Mei 2018, yakni fail di
/daftar/reka/*
sekarang didapati di/arkib/reka/*
dalam repositori.Nota 2: Hanya fail dokumentasi awal disenaraikan dalam isu ini, yakni fail dokumentasi yang dicipta antara tarikh isu ini dicipta dan ditutup (23 hingga 30 April 2018).
26 April 2018: Semua fail dokumentasi akan ditulis dalam format Markdown. Projek ini akan menggunakan GitHub Pages, dan fail dokumentasi lebih baik diterbitkan di dahan
gh-pages
. Dengan itu, fail lain boleh dikemas kini secara berasingan tanpa menjalankan pembinaan--terhad kepada 10 kali setiap jam menurut dokumen pada masa itu.26 April 2018 Jam 1648 GMT: Hm, nampaknya saya salah faham... Fungsi butang download di GitHub Pages adalah mengikut dahan sumber yang ditetapkan. Jika dahan
gh-pages
dipilih sebagai sumber, butang download akan muat turun fail daripada dahan itu sendiri! Sebelum ini, butang download disangka akan muat turun daripadamaster
--bukan rupanya. Kesimpulannya, fail dokumentasi akan dimuat naik ke/docs
di dahan master.