開発者こそドキュメント書くべきだ、みたいな話（仮）

2019年9月28日 SaCSS vol.106 で使用したスライド。

Transcript

1. ։ൃऀͦ͜υΩϡϝϯτॻ͘΂͖ͩɺ Έ͍ͨͳ࿩ʢԾʣ ଓɾ͸͔ͩͷԦ༷ͱωΠΩουɾϫϯμʔϥϯυ
5. ։ൃऀͦ͜υΩϡϝϯτॻ͘΂͖ͩ
6. ೒͸Կ৭
7. ࢵ ྘ ੨ ཟ ੺ ᒵ ԫ
8. ਓؒ͸ݴ༿ʹΑͬͯ
   ੈքʹ۠੾Γ໨ΛೖΕ͍ͯΔ
11. ෱Ԭ໊෺
    ໌ଠࢠ
12. ຯ෇͚ڕཛ
    ๺ւಓ࢈
13. ໊લΛ͚ͭΔ͜ͱͱ
    ೝࣝ͢Δ͜ͱ͸
    දཪҰମ
14. ʮ͍Βͭ͘ʯ ʮ͏͍͟ʯ ʮ͏͞Μ͍͘͞ʯ ʮጉጲແྱʯ ʮඇৗࣝʯ ʮෆ༇շʯ ʮ࢒೦Ͱ͢ʯ ʮແ੹೚ʯ ʮෆۘ৻ʯ ʮײ͡ѱ͍ʯ ʮ্͔Β໨ઢʯ ʮ͖΋͍ʯ ʮ࿝֐ʯ ʮؾ෼͕ѱ͍ʯ ʮ͍ͩ͞ʯ ʮত࿨͔ʯ
15. ʮ͍Βͭ͘ʯ ʮ͏͍͟ʯ ʮ͏͞Μ͍͘͞ʯ ʮጉጲແྱʯ ʮඇৗࣝʯ ʮෆ༇շʯ ʮ࢒೦Ͱ͢ʯ ʮແ੹೚ʯ ʮෆۘ৻ʯ ʮײ͡ѱ͍ʯ ʮ্͔Β໨ઢʯ ʮ͖΋͍ʯ ʮ࿝֐ʯ ʮؾ෼͕ѱ͍ʯ ʮ͍ͩ͞ʯ ʮত࿨͔ʯ
19. ։ൃऀͦ͜υΩϡϝϯτॻ͘΂͖ͩ
20. function update_user_email( ... ) { ... } function fn_02478( ... ) { ... } ⁞   ໊લ͸ॏཁ
21. ໊લΛ͚ͭΔ͜ͱͱ
    ೝࣝ͢Δ͜ͱ͸
    දཪҰମ
22. ཧղ͍ͯ͠ͳ͚Ε͹໊લΛ͚ͭΒΕͳ͍
    ໊લ͕ͳ͍ͳΒཧղ͍ͯ͠ͳ͍
23. ։ൃऀͦ͜υΩϡϝϯτॻ͘΂͖ͩ
24. υΩϡϝϯτΛॻ͘͜ͱͷར఺ w ٬؍తʹର৅Λଊ͑௚͢͜ͱ͕Ͱ͖Δ
    w ҧͬͨ֯౓͔Βର৅ΛݟΔ͜ͱͰཧղ͕ਂ·Δ
    w ਓʹઆ໌ΛࢼΈΔ͜ͱ͕Ұ൪ͷษڧʹͳΔ
25. ӳޠͰυΩϡϝϯτΛॻ͘ར఺ w ΑΓଟ͘ͷಡऀʹ఻ΘΔ
    w ؔ਺໊ͱ͔͍͍ͩͨӳ୯ޠ
    w ֎ࠃޠͰදݱ͢Δ͜ͱͰ͞Βʹཧղ͕ਂ·Δ
    w ӳޠͷֶशʹྑ͍
26. ӳจߍਖ਼αʔϏεΛ࢖͏ར఺ w ೔ӳٕज़຋༁ΑΓ௿ίετ
    w ٕज़༻ޠΛࣗ෼ͰࢦఆͰ͖ΔͷͰ࣮֬
    w ӳޠͷֶशʹྑ͍
    w ޡղΛੜ·ͳ͍ݴ͍ճ͠Λߟ͑Δश׳͕ͭ͘
27. IUUQTEFWFMPQFSTHPPHMFDPNTUZMF
28. ʮνΣοΫϘοΫεʹϚʔΫΛ͚ͭΔʯΛͲ͏දݱ͢Δ͔
29. ։ൃऀͦ͜υΩϡϝϯτॻ͘΂͖ɻ ͳͥͳΒυΩϡϝϯτΛॻ͘ߦҝ͕ ϓϩμΫτʹର͢ΔΑΓਂ͍ཧղΛ ଅ͔͢Βɻ ·ͱΊ