Latihan 1 dari materi Documentation as Code di Clean Code — praktek dengan editor kode interaktif, test case otomatis, dan hint terpandu. Langsung jalan di browser.
Implementasikan dua utilitas dokumentasi:
Bagian 1: parseJsDoc(comment)
Parse string komentar JSDoc menjadi data terstruktur.
"/** @param {string} name User name @param {number} age @returns {boolean} */"params: array { name, type, description? }returns: { type } atau null jika tidak ada @returnsBagian 2: validateAdr(adr)
Validasi objek ADR (Architecture Decision Record).
adr = { title, status, context, decision, consequences }status harus salah satu dari: 'proposed', 'accepted', 'deprecated', 'superseded'{ valid: boolean, errors: string[] } — daftar error untuk field yang kosong/tidak validCetak (urut):
r1.valid (ADR valid)r1.errors.length (tidak ada error)r2.valid (ADR tidak valid)r2.errors.length >= 2 (ada banyak error)