プãƒãƒ€ã‚¯ãƒˆé–‹ç™ºã§ãƒ‰ã‚ュメントを書ã‹ãªã„ã¨ã©ã†ãªã‚‹ã‹
Agile Manifestoã«ã¯ä»¥ä¸‹ã®ã‚ˆã†ã«æ›¸ã„ã¦ã‚ã‚Šã¾ã™ã€‚ 動作ã™ã‚‹ã‚½ãƒ•ãƒˆã‚¦ã‚¨ã‚¢ã¯åŒ…括的ãªãƒ‰ã‚ュメントã«ã¾ã•ã‚‹ ã¨ã‚‚ã™ã‚‹ã¨ãƒ‰ã‚ュメント軽視ã¨å–られã‹ããªã„宣言ã§ã™ã€‚ã“ã®å®£è¨€ã‚’誤ã£ã¦è§£é‡ˆã—ã¦ãƒ‰ã‚ュメントã¯ã„らãªã„ã¨ãªã‚‹å ´åˆã‚‚ã‚ã‚‹ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“ãŒç†è€…ã¯ãã‚Œã¯é–“é•ã„ã ã¨æ€ã£ã¦ã„ã¾ã™ã€‚ã“ã®å®£è¨€ã§ã¯åŒ…括的ãªãƒ‰ã‚ュメントよ
プãƒã‚°ãƒ©ãƒžãƒ¼ãŒãƒ‰ã‚ュメントを書ã‹ãªã„ç†ç”±
ã“ã®è¨˜äº‹ã¯ã€è‘—者ã®è¨±å¯ã‚’å¾—ã¦é…ä¿¡ã—ã¦ã„ã¾ã™ã€‚ Why programmers don’t write documentation 最近ã§ã¯ãšã£ã¨ã‚³ãƒ¼ãƒ‰ã®ãƒ‰ã‚ュメンテーションã«é–¢é€£ã—ãŸè¨˜äº‹ã‚’書ã„ã¦ã„ãŸã®ã§ã€å½“然ã€ç§ã®Mediumã®ãŠã™ã™ã‚記事ã«ã¯ã€Œé–‹ç™ºè€…ãŒãƒ‰ã‚ュメントを書ã‹ãªã„本当ã®ç†ç”±ã€ã¨ã„ã†è¨˜äº‹ãŒè¡¨ç¤ºã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®è¨˜äº‹ã§ã¯ã€ãƒ‰ã‚ュメントを書ããŸã‚ã®å„ªã‚ŒãŸãƒ„ールãŒãªã„ã“ã¨ãŒã€ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ãŒè‡ªåˆ†ã®ä½œæ¥ã‚„判æ–をドã‚ュメンテーションã™ã‚‹æ„欲を失ã‚ã›ã‚‹æœ€å¤§ã®åŽŸå› ã«ã¤ã„ã¦æ›¸ã„ã¦ã„ã¾ã™ã€‚ ç§ã¯æ™®æ®µã€ç‰¹å®šã®è¨˜äº‹ã‚’批判ã—ãŸã‚Šã¯ã—ã¾ã›ã‚“ãŒã€ã“ã®è¨˜äº‹ã«ã¯æ€’りを覚ãˆã¾ã—ãŸã€‚ã“ã®ãƒ©ã‚¤ã‚¿ãƒ¼ã¯å›³è§£ãƒ„ールã«ã¤ã„ã¦ã„ãã¤ã‹ãƒ¡ãƒªãƒƒãƒˆã«é–¢ã—ã¦è¿°ã¹ã¦ã¯ã„ã¾ã™ãŒã€å…¨ä½“çš„ã«èª¤è§£ã‚’æ‹›ãよã†ãªå†…容ã«ãªã£ã¦ãŠã‚Šã€ã“ã®é‡è¦ãªå•é¡Œã‚’より分ã‹ã‚Šã«ããã•ã›ã¦ã„ã¾ã™ã€‚2ã¤ã®å›³è§£ãƒ„ールを比較ã—ã¦ã€ã©ã¡ã‚‰ã‚‚ä¸å分ãªãƒ„ールã§ã‚ã‚‹
真é¢ç›®ãªäººã‚’本気ã«ã•ã›ã‚‹æ–¹æ³•
先日ã€ä»–社ã®é–‹ç™ºã®æ–¹ã€…ãŒã€ã‚¢ã‚¸ãƒ£ã‚¤ãƒ«ã«é–¢ã™ã‚‹ç›¸è«‡ã¨ã„ã†ã“ã¨ã§ã€å¼Šç¤¾ã«ã„るアジャイルã«è©³ã—ã„髪ã®é•·ã„ãŠã˜ã•ã‚“ã«è¨ªãã¦ããŸã€‚ãã®ä¸ã§ã€å®Ÿæ„Ÿé§†å‹•é–‹ç™ºã®è©±ã«ãªã£ã¦ã€ä¹…ã—ã¶ã‚Šã«ã€Œæœ¬æ°—（マジ）ã¨çœŸé¢ç›®ï¼ˆãƒžã‚¸ãƒ¡ï¼‰ã€ã®è©±ã‚’èžã„ãŸã€‚ ã“ã®è©±ã‚’èžã„ã¦ã‹ã‚‰ã€äººãŒãƒ—ãƒãƒ€ã‚¯ãƒˆã®ä¾¡å€¤ã«ã¤ã„ã¦è€ƒãˆã‚‰ã‚Œã‚‹ã‚ˆã†ã«ãªã‚‹ã«ã¯ã©ã†ã—ãŸã‚‰ã„ã„ã®ã‹è€ƒãˆã¦ã¿ãŸã€‚ TL;TRã‚ã‚ŠããŸã‚Šãªå›žç”ã ã‘ã‚Œã©ã€ã•ã£ã•ã¨ãƒªãƒªãƒ¼ã‚¹ã—ã¦ã€ã•ã£ã•ã¨ä½¿ã£ã¦ã‚‚らã†ã€‚ãれをã§ãã‚‹ãŸã‚ã®ã“ã¨ã‚’ã€ã‚‚ã¡ã‚んリスクを下ã’ã¤ã¤ã€ã§ãるよã†ã«ã™ã‚‹ãŸã‚ã®ã“ã¨ã‚’é ‘å¼µã‚ã†ã€‚ 本気ã¨çœŸé¢ç›® 人ã¯ãƒ‰ã‚ュメントをå‰ã«ã—ã¦çœŸé¢ç›®ãªæ…‹åº¦ã‚’å–ã‚‹ãŒã€å‹•ãソフトウェアをå‰ã«ã—ã¦æœ¬æ°—ã«ãªã‚‹ã€‚端的ã«è¨€ã†ã¨ã€äººã¯ä»•æ§˜æ›¸ãªã©ãƒ‰ã‚ュメントをå‰ã«ã™ã‚‹ã¨ãれを徹底的ã«é‡ç®±ã®éš…ã‚’çªãよã†ãªãƒ¬ãƒ“ュー（真é¢ç›®ï¼‰ã‚’ã—ã¦ã—ã¾ã†ãŒã€æœ¬å½“ã«æ¬²ã—ã‹ã£ãŸã“ã¨ã«å¯¾ã—ã¦è€ƒãˆå§‹ã‚る（本気）ã¯å®Ÿéš›ã®ãƒ—ãƒãƒ€ã‚¯ãƒˆã‚’å‰ã«ã—ã¦ã‹ã‚‰ã¨ã„ã†è©±ã
1
リリースã€éšœå®³æƒ…å ±ãªã©ã®ã‚µãƒ¼ãƒ“スã®ãŠçŸ¥ã‚‰ã›
最新ã®äººæ°—エントリーã®é…ä¿¡
処ç†ã‚’実行ä¸ã§ã™
j次ã®ãƒ–ックマーク
kå‰ã®ãƒ–ックマーク
lã‚ã¨ã§èªã‚€
eコメント一覧を開ã
oページを開ã
{{#tags}}- {{label}}
{{/tags}}