1"use strict";(globalThis.webpackChunkmy_website=globalThis.webpackChunkmy_website||[]).push([[14487],{1046(e,t,o){o.r(t),o.d(t,{assets:()=>l,contentTitle:()=>a,default:()=>u,frontMatter:()=>s,metadata:()=>n,toc:()=>c});const n=JSON.parse('{"type":"mdx","permalink":"/google-summer/gsod-summary-22","source":"@site/src/pages/google-summer/gsod-summary-22.md","title":"Google Season of Docs 2022 - Summary","description":"Project Abstract","frontMatter":{"title":"Google Season of Docs 2022 - Summary","og":"/img/og/google-summmer/gsod.jpg"},"unlisted":false}');var r=o(74848),i=o(28453);const s={title:"Google Season of Docs 2022 - Summary",og:"/img/og/google-summmer/gsod.jpg"},a="Google Summer of Docs \u2013 Project 2022",l={},c=[{value:"Project Abstract",id:"project-abstract",level:2},{value:"Participants",id:"participants",level:2},{value:"Pull Requests",id:"pull-requests",level:2},{value:"Deviations From Original Proposal",id:"deviations-from-original-proposal",level:2},{value:"Timeline",id:"timeline",level:2},{value:"<strong>June - July</strong>",id:"june---july",level:3},{value:"<strong>August</strong>",id:"august",level:3},{value:"<strong>September</strong>",id:"september",level:3},{value:"<strong>October</strong>",id:"october",level:3},{value:"<strong>November</strong>",id:"november",level:3},{value:"Results",id:"results",level:2},{value:"Contributor\u2019s Comments",id:"contributors-comments",level:2},{value:"Summary",id:"summary",level:2}];function d(e){const t={a:"a",blockquote:"blockquote",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",p:"p",strong:"strong",ul:"ul",...(0,i.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(t.header,{children:(0,r.jsx)(t.h1,{id:"google-summer-of-docs--project-2022",children:"Google Summer of Docs \u2013 Project 2022"})}),"\n",(0,r.jsx)(t.h2,{id:"project-abstract",children:"Project Abstract"}),"\n",(0,r.jsx)(t.p,{children:"In an open source project, a contributor onboarding guide gives potential project contributors a quick overview of how they might help with your project or study group. A newcomer may not know how to execute the aforementioned tasks successfully and efficiently if they do not have access to a solid contributor onboarding guide. These instructions can help secure a product's success by attracting new contributors, whose contributions will ensure the product's success. A great user guide simply takes that communication and organizes it into a framework that everyone can use to achieve success."}),"\n",(0,r.jsx)(t.h2,{id:"participants",children:"Participants"}),"\n",(0,r.jsxs)(t.p,{children:["The ",(0,r.jsx)(t.code,{children:"project team"})," members on this project were:"]}),"\n",(0,r.jsxs)(t.ul,{children:["\n",(0,r.jsxs)(t.li,{children:[(0,r.jsx)(t.a,{href:"https://github.com/Asmit2952",children:"Asmit Malakannawar"})," \u2013 GSoD Student \u2013 Technical Writer"]}),"\n",(0,r.jsxs)(t.li,{children:[(0,r.jsx)(t.a,{href:"https://github.com/sebawita",children:"Sebastian Witalec"})," \u2013 GSoD Mentor \u2013 Developer Advocate"]}),"\n"]}),"\n",(0,r.jsx)(t.h2,{id:"pull-requests",children:"Pull Requests"}),"\n",(0,r.jsxs)(t.p,{children:[(0,r.jsx)(t.a,{href:"https://github.com/semi-technologies/weaviate-io/pulls?q=is%3Apr+author%3AAsmit2952+",children:"List of PRs"})," that include more details and discussion:"]}),"\n",(0,r.jsx)(t.h2,{id:"deviations-from-original-proposal",children:"Deviations From Original Proposal"}),"\n",(0,r.jsxs)(t.p,{children:["In the initial proposal, Asmit solely proposed the creation of a contributor's guide. But as the ",(0,r.jsx)(t.code,{children:"project team"})," worked on the documentation updates, it became apparent that the tooling (based on Ruby and Jekyll) used to build Weaviate docs was a significant obstacle for new contributors, as it was slow and difficult to set up."]}),"\n",(0,r.jsxs)(t.p,{children:["To address that, Asmit researched and experimented with other open-source tools for building documentation sites. As a result, we decided to move all of our structured documentation to ",(0,r.jsx)(t.a,{href:"https://docusaurus.io/",children:"Docusaurus"}),", enabling contributors and the Weaviate team to work on the documentation with ease."]}),"\n",(0,r.jsxs)(t.blockquote,{children:["\n",(0,r.jsx)(t.p,{children:"Note \u2013 the new documentation website is still under construction, and we are still working with the team to set it up successfully. The planned release date is set for late December 2022."}),"\n"]}),"\n",(0,r.jsx)(t.p,{children:"As a proof of concept, we created a sample site and deployed it on Vercel. Here are the links to the repository and the PoC website:"}),"\n",(0,r.jsxs)(t.ul,{children:["\n",(0,r.jsx)(t.li,{children:(0,r.jsx)(t.a,{href:"https://github.com/Asmit2952/weaviate-docusaurus",children:"PoC repository"})}),"\n",(0,r.jsx)(t.li,{children:(0,r.jsx)(t.a,{href:"https://weaviate-docusaurus.vercel.app/developers/weaviate/",children:"Docs - preview"})}),"\n",(0,r.jsx)(t.li,{children:(0,r.jsx)(t.a,{href:"https://weaviate-docusaurus.vercel.app/developers/contributor-guide/",children:"Contributor's Guide - preview"})}),"\n",(0,r.jsx)(t.li,{children:(0,r.jsx)(t.a,{href:"https://docs.weaviate.io/contributor-guide/",children:"Contributor's Guide - in production"})}),"\n"]}),"\n",(0,r.jsx)(t.h2,{id:"timeline",children:"Timeline"}),"\n",(0,r.jsx)(t.p,{children:"Here are some milestones from the project timeline."}),"\n",(0,r.jsx)(t.h3,{id:"june---july",children:(0,r.jsx)(t.strong,{children:"June - July"})}),"\n",(0,r.jsx)(t.p,{children:"Audited the current Contributor\u2019s Guide and prepared a list of suggestions."}),"\n",(0,r.jsx)(t.p,{children:"Created the mockups on how a contributor's guide should look, with a list of pages and content the final Contributor\u2019s Guide should contain."}),"\n",(0,r.jsx)(t.h3,{id:"august",children:(0,r.jsx)(t.strong,{children:"August"})}),"\n",(0,r.jsx)(t.p,{children:"Created a writing plan, with the step by step process of writing a beginner friendly doc."}),"\n",(0,r.jsx)(t.p,{children:"Started the work on Contributor\u2019s Guide."}),"\n",(0,r.jsx)(t.p,{children:"Added issue and PR templates."}),"\n",(0,r.jsx)(t.h3,{id:"september",children:(0,r.jsx)(t.strong,{children:"September"})}),"\n",(0,r.jsx)(t.p,{children:"Completed the first draft of the Contributor's Guide ."}),"\n",(0,r.jsx)(t.p,{children:"Compared multiple online documentation options and selected Docusaurus."}),"\n",(0,r.jsx)(t.h3,{id:"october",children:(0,r.jsx)(t.strong,{children:"October"})}),"\n",(0,r.jsx)(t.p,{children:"Created a proof of concept for Docusaurus and iterated it based on reviews."}),"\n",(0,r.jsx)(t.p,{children:"Checked the documentation for errors and typos."}),"\n",(0,r.jsx)(t.h3,{id:"november",children:(0,r.jsx)(t.strong,{children:"November"})}),"\n",(0,r.jsx)(t.p,{children:"Project approved by the mentor and the Weaviate team."}),"\n",(0,r.jsx)(t.h2,{id:"results",children:"Results"}),"\n",(0,r.jsxs)(t.ul,{children:["\n",(0,r.jsx)(t.li,{children:"Created a detailed contributor\u2019s guide. Including detailed guides on basic git and GitHub workflow."}),"\n",(0,r.jsx)(t.li,{children:"Improved overall contributor experience \u2013 not only for beginners but also for current contributors."}),"\n",(0,r.jsx)(t.li,{children:"Made navigation easier by pointing contributors in the right direction."}),"\n",(0,r.jsx)(t.li,{children:"Updated GitHub issue and PR templates to make it easy for c
1ontributors to contribute to the documentation"}),"\n"]}),"\n",(0,r.jsx)(t.h2,{id:"contributors-comments",children:"Contributor\u2019s Comments"}),"\n",(0,r.jsx)(t.p,{children:"\u201cMy involvement with Weaviate and the Google Season of Docs internship both helped me advance my knowledge of technical documentation. I gained a lot of knowledge about working with others, understanding a startup, and identifying opportunities to contribute. I've never had the chance to collaborate with an emerging open-source company more frequently. I appreciate the opportunity to work with Weaviate\u2019s team on this project."}),"\n",(0,r.jsx)(t.p,{children:"The project gave me numerous chances to brush up on my current knowledge of React, Docusaurus, and Jekyll, to mention a few, while working on the project. While the GSoD 2022 project comes to an end, Weaviate's documentation journey will continue.\u201d"}),"\n",(0,r.jsx)(t.h2,{id:"summary",children:"Summary"}),"\n",(0,r.jsx)(t.p,{children:"Overall the project was a success, and we achieved our documentation deliverables."}),"\n",(0,r.jsx)(t.p,{children:"We also started working on a new documentation site, making it a lot easier for anyone to contribute to Weaviate and our docs."}),"\n",(0,r.jsxs)(t.p,{children:["We want to give big thanks to Asmit \u2013 for the hard work he put into this project \u2013 and to GSoD \u2013 for organising such a fantastic project.",(0,r.jsx)("br",{}),"\nThanks to this project, our documentation and the contributor\u2019s journey are better than ever.."]})]})}function u(e={}){const{wrapper:t}={...(0,i.R)(),...e.components};return t?(0,r.jsx)(t,{...e,children:(0,r.jsx)(d,{...e})}):d(e)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.