search

kidino / buku-git

Usaha kolektif untuk membangunkan bahan rujukan untuk Git dalam bahasa Melayu
https://kidino.github.com/buku-git
31 stars 31 forks source link

Peringatan - Perlu semak semula suntingan perjalanan pembacaan #13

Open kidino opened 8 years ago

kidino commented 8 years ago

Setakat ini saya terima dulu pelbagai penulisan, kod-kod lain lain-lain. Tapi peringatan untuk saya, dan yang mungkin kemudian boleh membantu dari segi penyuntingan dan editorial, keseluruhan buku perlu ada kesinambungan dalam pembacaan.

adyromantika commented 8 years ago

Menyebut tentang kesinambungan, saya terfikir sekiranya kita hasilkan satu repo sebagai contoh ataupun cukup dengan struktur direktori sebagai asas, semua penyumbang kepada buku ini boleh merujuk kepada struktur asas dan menghasilkan contoh-contoh lebih baik daripadanya. Jadi kesinambungan lebih terjamin.

Sebagai contoh, jika pada awalan topik kita berikan pembaca struktur asas seperti ini dan penyumbang gunakannya sebagai asas untuk contoh-contoh:

/
    .gitignore
    mygit/
        libs/
        tools/
            utils/
                sample.txt
            more_utils/
                sample_dir/
                    sample_file.txt
        utils/
            sample_dir/
                sample_file1.c
                ...

Penyumbang dibenarkan untuk menambah kepada struktur asas untuk menjadikan contoh lebih mudah difahami, tetapi pembuangan harus diperiksa dengan lebih teliti supaya tidak mengganggu contoh-contoh sedia ada.

Sekadar berkongsi buah fikiran.

MakLaN commented 8 years ago

Penggunaan analogi: Bab awal mewujudkan watak Johan yang nak gunakan Git untuk Syarikat Sistem Sdn Bhd. Adakah Johan tu problem statement atau sekadar contoh untuk bab permulaan? Kalau nak kekalkan Johan dalam setiap bahagian saya rasa ok, cuma kena ada kesinambungan. Kalau tak nampak macam tergantung.