यह कुछ भी विवादास्पद विषय लगता है कि "जावाबीन" सिंटैक्स प्राप्त करने और खेतों के लिए बसने सहित सब कुछ दस्तावेज करने के लिए: लोग कहते हैं कि इसकी अनावश्यक रूप से लंबी और दोहराव तोड़ने वाली DRY (खुद को दोहराएं नहीं) , कि नामकरण सम्मेलन सब कुछ समझा सकता है , और यह कोड / प्रलेखन को बंद कर देता है। कभी-कभी वे तर्क काम करते हैं। लेकिन अन्य बार, आप इसे समाप्त करते हैं:
ऊपर स्रोत परियोजनाओं को खोलने के लिए आम है जो साहसपूर्वक उन सिद्धांतों का पालन करते हैं। आप पूरी तरह से बेकार प्रलेखन के साथ रह गए हैं । जो कुछ भी चल रहा है उसके बारे में कुछ भी स्पष्ट नहीं करता है, संभावित प्रभाव, या यहां तक कि अपेक्षित मूल्य क्या है (क्या यह शून्य या कभी शून्य हो सकता है? मुझे नहीं पता; जावदोक मुझे नहीं बताता)।
तो मुझे कब दस्तावेज़ देना चाहिए? क्या मैं सब कुछ दस्तावेज़ करता हूं, भले ही यह कभी-कभार कोड को कोड कर दे? या क्या मैं अपनी आँखों से कुछ भी दस्तावेज नहीं करता, यह "स्पष्ट" है?