- दस्तावेज़ों के भीतर code snippets को वास्तव में executable बनाकर runbook, ऑपरेशन दस्तावेज़ और README की उपयोगिता/विश्वसनीयता बढ़ाने के लिए विकसित किया गया
- Markdown के code blocks को जैसा है वैसा execute करके दस्तावेज़ को चरण-दर-चरण आसानी से फ़ॉलो और सत्यापित किया जा सकता है
- कमांड चलाएँ, बीच के परिणाम देखें, और जाँचें कि इच्छित output हासिल हुआ है या नहीं
- Shell/Bash, Python, JavaScript/TypeScript, Ruby आदि विभिन्न runtimes को shebang-आधारित तरीके से सपोर्ट करता है
- code cells चलाते समय environment variables और execution context को बनाए रखता है, जिससे terminal session की तरह step-by-step execution संभव होता है
- पिछले cell के output को अगले cell तक पहुँचाने वाला pipeline-शैली execution flow भी सपोर्ट करता है
- Makefile, npm scripts, Gradle, Deno task जैसी मौजूदा task definitions के साथ पूरी तरह compatible है
run, list, print कमांड के जरिए दस्तावेज़ के भीतर executable workflows को explore, execute और verify किया जा सकता है
- ऑपरेशन दस्तावेज़ों में bitrot की समस्या को कम करता है, और ऐसे प्रैक्टिकल दस्तावेज़ों के लिए विशेष रूप से उपयुक्त है जिनमें step-by-step execution की ज़रूरत होती है
- bitrot: वह स्थिति जिसमें दस्तावेज़ या code समय के साथ वास्तविक environment से अलग हो जाते हैं और धीरे-धीरे अपनी विश्वसनीयता खो देते हैं
- Homebrew, npm, Go install, single binary आदि के ज़रिए install किया जा सकता है
- Apache 2.0 लाइसेंस
अभी कोई टिप्पणी नहीं है.