Apa spesifikasi teknisnya? Apakah mereka sama dengan dokumen desain. Jika tidak, apa bedanya dan beberapa
Perusahaan saya ingin meningkatkan manajemen data riset pasar mereka. Gaya manajemen data saat ini: "Hei Jimbo, di mana gambar WhatZit 2.0 kita? "Ya, aku ingat email tentang perusahaan itu dari orang itu, beri aku beberapa menit untuk mencari di Outlook-ku" "Siapa yang memiliki salinan terbaru...
Kami mencoba untuk memindahkan proses dokumentasi proyek kami dari Google Documents ke satu set repositori Git yang di-host-sendiri. Dokumen teks cukup ramah Git, karena biasanya kita tidak memerlukan pemformatan mewah, kami hanya akan mengonversi semuanya menjadi, katakanlah, multimarkdown dengan...
Saya bekerja sebagai bagian dari tim pada aplikasi yang sudah ada yang tidak memiliki dokumentasi sebaris, juga tidak memiliki dokumentasi teknis. Karena saya telah mengerjakan berbagai laporan bug pada aplikasi, saya telah menulis semacam jejak remah roti untuk saya sendiri - nomor bug di berbagai...
Saya saat ini magang di kontraktor pemerintah dan saya merasa (secara tidak terhindarkan) merasa bahwa Word adalah standar de-facto dalam proses pengembangan perangkat lunak. Format binernya membuatnya sangat sulit untuk berkolaborasi pada dokumen dengan cara saya terbiasa berkolaborasi pada basis...
Kapan orang mulai menulis file Readme? Tampaknya hampir semua program memiliki file ini, apa pun formatnya. Apakah ada penggunaan pertama dokumen ini yang
Ada beberapa contoh kode yang didokumentasikan dengan baik di luar sana, seperti java api. Tetapi, banyak kode dalam proyek publik seperti git dan proyek internal perusahaan tidak terdokumentasi dengan baik dan tidak terlalu ramah bagi pendatang baru. Dalam semua tugas pengembangan perangkat lunak...
Di tempat kerja saya, kami menghadapi tantangan karena "gesit" terlalu sering berarti "persyaratan yang tidak jelas, kriteria penerimaan yang buruk, semoga sukses!" Kami mencoba mengatasinya, sebagai upaya peningkatan umum. Jadi, sebagai bagian dari itu, saya mengusulkan agar kami membuat dokumen...
Pengembangan Behavior-Driven dengan simbol skenario "Given-When-Then" simbolik akhir-akhir ini cukup populer karena kemungkinan penggunaannya sebagai objek batas untuk penilaian fungsionalitas perangkat lunak. Saya pasti setuju bahwa Gherkin , atau skrip definisi fitur mana pun yang Anda inginkan,...
Saya telah mengerjakan proyek selama beberapa tahun sekarang, dan saya mulai mengumpulkan basis pengguna yang layak. Saya telah membuat halaman proyek dengan beberapa dokumentasi dasar, tetapi sebenarnya tidak lebih dari sebuah FAQ pada saat ini. Saya tahu bahwa saya perlu memperbaikinya sehingga...
Mengapa dokumentasi pada beberapa bahasa mengatakan "setara dengan" daripada "adalah"? Sebagai contoh, Python Docs berkata itertools.chain(*iterables) ... Setara dengan: def chain(*iterables): # chain('ABC', 'DEF') --> A B C D E F for it in iterables: for element in it: yield...
Ditutup . Pertanyaan ini perlu lebih fokus . Saat ini tidak menerima jawaban. Ingin meningkatkan pertanyaan ini? Perbarui pertanyaan sehingga berfokus pada satu masalah hanya dengan mengedit posting ini . Ditutup tahun lalu . Saya ingin mendokumentasikan...
Saya tidak dapat menghitung berapa kali saya membaca pernyataan dalam uraian 'tes unit adalah sumber dokumentasi yang sangat penting dari kode yang diuji'. Saya tidak menyangkal mereka benar. Tetapi secara pribadi saya belum menemukan diri saya menggunakannya sebagai dokumentasi. Untuk kerangka...
Tampaknya sedikit subjek yang kontroversial untuk mendokumentasikan segala sesuatu, termasuk sintaks "JavaBean" getter dan setter untuk bidang: Orang - orang mengatakan bahwa KERING panjang dan berulang-ulang yang tidak perlu (jangan ulangi sendiri) , bahwa konvensi penamaan harus menjelaskan...
Kami sedang menulis spesifikasi fungsional dan teknis dalam format dua kolom; kalimat ringkasan dan detail teknis. Detail sering merujuk pada lampiran dengan diagram, desain tata letak dll. Namun saya berjuang dengan apa yang tegang untuk menuliskannya di: Dengan lampau seolah-olah pekerjaan itu...
Jadi kami memiliki antarmuka seperti itu /// <summary> /// Interface for classes capable of creating foos /// </summary> public interface ICreatesFoo { /// <summary> /// Creates foos /// </summary> void Create(Foo foo); /// <summary> /// Does Bar stuff ///...
Latar Belakang: Kolaborator saya dan saya sedang menulis artikel untuk jurnal akademik. Dalam perjalanan penelitian kami, kami menulis sebuah program simulasi di Jawa. Kami ingin membuat program simulasi tersedia secara bebas untuk digunakan orang lain. Kami telah memutuskan untuk meng-hosting...
Terkadang, meski tidak sering, saya harus memasukkan logika matematika ke dalam kode saya. Konsep yang digunakan sebagian besar sangat sederhana, tetapi kode yang dihasilkan tidak - banyak variabel dengan tujuan yang tidak jelas, dan beberapa operasi dengan maksud yang tidak begitu jelas. Saya...
Ditutup . Pertanyaan ini didasarkan pada pendapat . Saat ini tidak menerima jawaban. Ingin meningkatkan pertanyaan ini? Perbarui pertanyaan sehingga dapat dijawab dengan fakta dan kutipan dengan mengedit posting ini . Ditutup 6 tahun yang lalu . Setelah...
Ditutup . Pertanyaan ini didasarkan pada pendapat . Saat ini tidak menerima jawaban. Ingin meningkatkan pertanyaan ini? Perbarui pertanyaan sehingga dapat dijawab dengan fakta dan kutipan dengan mengedit posting ini . Ditutup 5 tahun yang lalu . Semua...