Designing DocC for Clarity and Beauty

Transcript

1. %FTJHOJOH
   %PD$
   GPS
   $MBSJUZ
   BOE
   #FBVUZ .BTUFSJOH
   *NBHF
   *NQMFNFOUBUJPO FMNFUBM
   $ZCP[V
   *OD
   ؔ੢ϞόΠϧΞϓϦݚڀձ"
   
   
2. "CPVU
   NF  J04
   "QQ
   %FWFMPQFS ڝഅ ରઓήʔϜ ҭࣇ ෳ਺νʔϜͷ
   ٕज़ࢧԉ !FM@NFUBM@
3. ៉ྷͳυΩϡϝϯτ࡞Γ͍ͨ 
4. )VNBO
   *OUFSGBDF
   (VJEFMJOFT ៉ྷͳυΩϡϝϯτ୅ද 
5. %PD$ͰͰ͖·͢ 
6. -JOLT ϦϯΫͷຒΊࠐΈϓϨϏϡʔ༻ͷσΟϨΫςΟϒ @Links(visualStyle: VisualStyle) { ... }  visualStyle ϦϯΫͷϨϯμϦϯά࣌ʹ࢖༻͢ΔελΠϧͷࢦఆ
   list ϦϯΫઌͷϖʔδͷ׬શͳએݴͱ֓ཁΛؚΉϦετܗࣜ
   compactGrid ϦϯΫઌͷϖʔδͷΧʔυը૾ʹج͍ͮͨΞΠςϜͷάϦουܗࣜ
   ֤ϖʔδͷλΠτϧͱΧʔυը૾͸ؚ·ΕΔ͕ɺ֓ཁ͸ؚ·Εͳ͍
   detailedGrid ϦϯΫઌͷϖʔδͷΧʔυը૾ʹج͍ͮͨΞΠςϜͷάϦουܗࣜ
   compactGridͱ͸ҧͬͯɺ֤ϖʔδͷ֓ཁؚ͕·ΕΔ
7. 1BHF*NBHF ը૾ͱϖʔδͷඥ෇͚༻σΟϨΫςΟϒ @PageImage(purpose: Purpose, source: ResourceReference, alt: String?)  purpose ը૾ͷ༻్
   icon αΠυόʔͳͲͰ༻͍ΒΕΔϖʔδͷΞΠίϯදݱͷը૾
   card άϦουελΠϧͷτϐοΫηΫγϣϯͳͲͰ༻͍ΒΕΔϖʔδͷΧʔυදݱͷը૾
   source υΩϡϝϯςʔγϣϯΧλϩά಺ͷը૾ͷϕʔεϑΝΠϧ໊
   alt εΫϦʔϯϦʔμʔ޲͚ͷը૾ͷ୅ସςΩετ
8. ΍ͬͯΈͨ
9. 4XJGU6*
   7JFX
   $PEJOH
   (VJEFMJOFT ը૾ͰϦϯΫΛදࣔ 
10. 4XJGU6*
    7JFX
    $PEJOH
    (VJEFMJOFT αΠυόʔ΍ΞΠίϯͷΧελϜ 
11. 8FC6* ΞΠίϯͱ৭ΛΛΧελϜ 
12. ࢀߟ https://developer.apple.com/jp/videos/play/wwdc2023/10244/ 4XJGU%PD$Ͱॆ࣮ͨ͠υΩϡϝϯτΛ࡞੒ %PD$ https://www.swift.org/documentation/docc DZCP[VTXJGUVJWJFXDPEJOHHVJEFMJOFT https://github.com/cybozu/swiftui-view-coding-guidelines DZCP[V8FC6* https://github.com/cybozu/WebUI