Google Season of Docs 2021

...

Contact(s) / potential mentors(s): Mentor(s) name and contact details

Associated JBoss community project(s): 

Idea Proposals

Project title: Review and Revamp the Glossary Page on WildFly Docs

Summary of idea:
Many new beginners while starting their journey with JBOSS, want to become more familiar with the common terms used in the WildFly world.
The glossary page should have a list of such terms/words which will help a new contributor have more familiarity with the technical terms.
The glossary will also point to few quick start guides which will complete the loop and have the contributors use WildFly right away.

-Idea
1. Build a strong and meaningful glossary page
2. Integrate some with the quickstart guides repo

Knowledge prerequisite: JAVA, GIT, Shell, Maven, asciidoc

Github repo: https://github.com/wildfly/wildfly/tree/master/docs

Skill level: Beginner/Intermediate

Contact(s) / potential mentors(s): Sudeshna Sur (sudeshna@redhat.com)

Associated JBoss community project(s): WildFly

Infinispan Project Proposal for GSoD 2021

About Infinispan

Infinispan is an in-memory, distributed data store. It’s a fast-paced open source project teamed with energetic, yet laid-back, developers and community contributors. It’s a small team but we get lots done while trying to inspire the best in ourselves and each other.

As a technology offering, Infinispan is used as an application caching layer for high performance and fault-tolerant access to data. Infinispan is also sponsored by Red Hat and used in several large organizations to ensure business continuity. Because Infinispan is quite elastic by nature, it scales easily and is suited for cloud-native applications and efficient resource usage.

Infinispan’s documentation set has recently expanded to include user stories for our Kubernetes Operator while also adopting a more task-oriented, topic-based approach to content development. We’re looking for technical writers who are tech-savvy and like to roll up their sleeves and dig into projects. This is a good opportunity for a junior writer to gain experience with an open-source project and build a portfolio. Writers with more experience might find opportunities for learning modern technology usage patterns, improving continuous delivery pipelines for documentation, and contributing to overall content strategy.

Participants and roles

• Don Naro, Tristan Tarrant 
• dnaro@redhat.com, ttarrant@redhat.com 
• https://infinispan.zulipchat.com 

Information for technical writers

Before you begin:

• Familiarity with Java and Maven. 
• Be able to find your way around a Linux terminal.
• A GitHub account so you can fork our repositories.
• You also need an abundance of patience and willingness to make mistakes and ask questions.
• Our Contributor’s Guide has some doc guidelines: https://infinispan.org/docs/stable/titles/contributing/contributing.html 
• We also follow guidelines for Red Hat documentation: https://redhat-documentation.github.io/ 

What you will lean:

• Git workflows
• Asciidoc
• Docs-as-code methodologies
• Interviewing and research skills + data analysis
• Working in an agile environment to develop and improve documentation

What you will do:

• There’s too much to sum up in a single bullet point. You will get opportunities to assist with content creation; help manage, maintain, and integrate our documentation set; do peer reviews and editing; work with PatternFly UX and microcopy writers to improve inline help. There are many different aspects where you can help out.
• Work alongside Don, the primary technical writer for the Infinispan project, to figure out where to start and identify some doc tasks.
• Ideally part of your contribution will be to help us improve consistency with terminology and style.

Project ideas

• General documentation maintenance tasks
• Adhering to file naming conventions
• Standardizing/cleaning up anchors
• Structural improvements
• Terminology and style consistency
• Sentence casing for titles
• Validating configuration examples and removing stale examples

• Configuration guide
• Breaking the chapter on partition handling into a user story
• Reorganizing chapters and editing content for grammar and style
• Improving graphics
• Rewriting the first couple chapters about the Cache API and cache modes into user stories

• Developer’s guide
• Edits for grammar, style, clarity
• Reorganizing chapters and editing content
• Validating configuration examples

• Console
• Externalize microcopy strings to en.json

• Technical Overview / FAQ 
• Clean up stale content, reorganize, and rewrite

• Hot Rod Java Client Guide
• Reorganizing chapters and editing content for grammar and style
• Validating configuration examples

• Infinispan.org (community website)
• Helping out with issues such as https://github.com/infinispan/infinispan.github.io/issues/170 
• Developing use cases
• Identifying and proposing improvements to the site