github.com/projectcontour/contour@v1.28.2/site/content/posts/2021-06-10-docs-wg.md (about)

     1  ---
     2  title: Join the Contour Tech Docs Working Group
     3  excerpt: Announcing Contour Technical Documentation Working Group
     4  author_name: Contour Team
     5  author_avatar: /img/contributors/orlin-vasilev.jpg
     6  categories: [kubernetes]
     7  tags: ['Contour Team', 'Abigail McCarthy', 'Docs' ,'Docs-WG', 'Jonas Rosland', 'Orlin Vasilev']
     8  date: 2021-06-10
     9  slug: docs-wg
    10  ---
    11  
    12  The Contour team is excited to announce we are launching a technical documentation working group. This group will focus on improving the Contour website, documentation, and processes around content creation.
    13  
    14  # Because documentation makes a difference
    15  
    16  In 2017, GitHub conducted the [Open Source Survey](https://opensourcesurvey.org/2017/), which sampled 5,500 respondents. One of the key takeaways was that “documentation is highly valued, but often overlooked.” The survey found that outdated or confusing documentation was a major problem, affecting 93% of respondents. Yet 60% of contributors rarely or never contribute to documentation. We want this working group to be an opportunity to give back to the community by helping to improve the docs.
    17  
    18  # The purpose and scope of the Working Group
    19  
    20  The purpose of the Working Group is to build up a self-sustaining community around documentation for Contour. We have an initial need to rework the existing documentation based on the recommendations outlined in the [CNCF Tech Docs Review](https://github.com/cncf/techdocs/blob/main/assessments/0001-contour.md), and a continuous need for documentation being added/edited/removed for releases going forward.
    21  This group is open to contributors of all levels, the only requirement is being interested in helping with docs!
    22  
    23  # How to participate
    24  Join us for our kickoff meeting on June 17th at 1PM Eastern Standard/Daylight Time [Time zone converter](https://www.timeanddate.com/worldclock/usa/boston) as part of the Contour Office Hours. During the kickoff meeting, we’ll have an information session about this working group, covering the following topics
    25  
    26  - Working Group participation
    27  - The docs tool chain and how to set up your environment
    28  - How to preview the documentation locally before submitting a pull request
    29  - Anything else you’d like to know about helping with Contour documentation!
    30  
    31  We’ll be continuing to hold Working Group meetings and information sessions during the regular Contour Office Hours time every 1st and 3rd Thursday at 1PM after the kickoff meeting. 
    32  Get the invite to the Contour Office Hours by joining the [Contour mailing list](https://lists.cncf.io/g/cncf-contour-users/).
    33  
    34  You can find the [Contributing Guide here](/resources/contributing-docs).
    35  # We look forward to seeing you!
    36  Thank you for being willing to take time from your schedule to participate in the Contour Tech Docs Working Group. Your help will drive new user guides and better documentation for the project, enriching the community for everyone by teaching new and experienced contributors and users the fundamental concepts of Contour and how to use it.
    37  We hope to see you soon!
    38  
    39  # Authors
    40  - Abigail McCarthy - @a-mccarthy
    41  - Jonas Rosland - @jonasrosland
    42  - Orlin Vasilev - @OrlinVasilev