<div dir="ltr"><div dir="ltr"><span id="gmail-docs-internal-guid-85f0997e-7fff-6680-657b-44142481e02b" style="color:rgb(0,0,0);font-family:-webkit-standard"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-family:"Nunito Sans",sans-serif;font-size:11pt;white-space:pre-wrap;background-color:transparent">Hey everyone,</span><br></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-family:"Nunito Sans",sans-serif;font-size:11pt;white-space:pre-wrap;background-color:transparent"><br></span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:10pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">Next week is the official start of doc development for Google Season of Docs. This part of the program lasts for three months (Sept. 2 - November 22).</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">Here’s a high-level overview of the items that I’d like to tackle during that time:</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;white-space:pre-wrap;background-color:transparent;font-family:"Nunito Sans",sans-serif">1. Restructure the LLVM docs homepage.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;white-space:pre-wrap;background-color:transparent;font-family:"Nunito Sans",sans-serif">2. Reorganize the User Guides, Programming Documentation, and Subsystem Documentation topics into specific categories/pages.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;white-space:pre-wrap;background-color:transparent;font-family:"Nunito Sans",sans-serif">3. Update the Sphinx/reStructuredText style guide.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;white-space:pre-wrap;background-color:transparent;font-family:"Nunito Sans",sans-serif">4. Misc. site enhancements, doc updates, bug fixes, etc.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap"><br></span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">Per the guidelines outlined in the LLVM Developer Policy, I’ll be taking an incremental/iterative approach by breaking up my updates into smaller chunks. </span><span style="font-family:"Nunito Sans",sans-serif;font-size:11pt;white-space:pre-wrap;background-color:transparent">The first item I’ll be working on is a revamp of the existing LLVM Docs homepage. The updated homepage will (initially) consist of the following four sections:</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap"># About</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap"># LLVM Design and Overview</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap"># Documentation</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap"># Community</span></p><div dir="ltr"><span style="color:rgb(0,0,0);font-family:-webkit-standard"><br></span></div>---<br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><br></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">- Each section will include introductory text along with links to relevant topics. For this first iteration, I don’t anticipate making any large-scale changes to the existing text/links.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">- I’ll be temporarily moving the User Guides, Programming Documentation, and Subsystem Documentation sections to separate pages. Links to each page will be included under the “Documentation” section.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">- The Documentation section is intended to be a temporary placeholder. It will eventually be split into multiple sections. For example, a section for Getting Started, How-Tos, Tutorials, Reference, etc. This work will be included as part of my second task to reorganize the existing docs into specific categories/pages. I’ll go over my proposal for this task at a later date.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">In the meantime, if you have any questions or suggestions, let me know.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">Thanks!</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:"Nunito Sans",sans-serif;background-color:transparent;font-variant-ligatures:normal;font-variant-east-asian:normal;vertical-align:baseline;white-space:pre-wrap">DeForest</span></p></span></div></div>