Title: Overview
Author: Milana Cap
Published: May 19, 2023

---

# Overview

**Table of contents**

 * What skills do I need?
 * How much experience with WordPress do I need?
 * Which accounts do I need?
 * Places where the Docs team operates
 * When and where are meetings happening?
 * What type of meetings does the Docs team hold?
 * What contribution can I make after this onboarding session?
 * How do I work with GitHubGitHub GitHub is a website that offers online implementation
   of git repositories that can easily be shared, copied and modified by other developers.
   Public repositories are free to host, private repositories require a paid subscription.
   GitHub introduced the concept of the ‘pull request’ where code changes done in
   branches by contributors can be reviewed and discussed before being merged by
   the repository owner. [https://github.com/](https://github.com/) issues?
 * Show me documentation

**What skills do I need?**

 * English language

**How much experience with WordPress do I need?**

 * Anything in between none and a lot. The best documentation is written when you
   do things for the first time. Also, if you don’t have any experience with WordPress,
   then you are the best person to validate existing documentation and point to 
   possible holes in it.

**Which accounts do I need?**

 * [WordPress.org account](https://login.wordpress.org/register).
 * [WordPress Slack account](https://make.wordpress.org/chat/) (wordpress.orgWordPress.
   org The community site where WordPress code is created and shared by the users.
   This is where you can download the source code for WordPress core, plugins and
   themes as well as the central location for community conversations and organization.
   [https://wordpress.org/](https://wordpress.org/) account is needed).
 * [GitHub account](https://github.com/signup) – connect [your GitHub account to your WordPress.org profile](https://make.wordpress.org/core/2020/03/19/associating-github-accounts-with-wordpress-org-profiles/).

**Places where the Docs team operates:**

 * [Blog](https://make.wordpress.org/docs/) – for meeting agendas and summaries (
   and anything related to the Docs team).
 * [Slack channel #docs](https://wordpress.slack.com/archives/C02RP4WU5) – where
   meetings are happening (and all communication regarding the team itself).
 * [GitHub repository](https://github.com/WordPress/Documentation-Issue-Tracker)–
   where issues for all documentation are reported, discussed and worked on.
 * [Handbook](https://make.wordpress.org/docs/handbook/) – how to contribute to 
   the Documentation team (it’s a bit out of date).
 * [Style guide](https://make.wordpress.org/docs/style-guide/) – for how to write
   WordPress documentation.

**When and where are meetings happening?**
Meetings happen in [#docs](https://wordpress.slack.com/archives/C02RP4WU5)
SlackSlack Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/).
The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/)
channel. Days and timing can be found in several places: The Welcome box (on the
top of every page in this handbook or blog), the sidebarSidebar A sidebar in WordPress
is referred to a widget-ready area used by WordPress themes to display information
that is not a part of the main content. It is not always a vertical column on the
side. It can be a horizontal rectangle below or above the content area, footer, 
header, or any where in the theme. on the [blog page](https://make.wordpress.org/docs/),
[global meeting calendar](https://make.wordpress.org/meetings/).

**What type of meetings does the Docs team hold?**

 * **Regular meetings** – in the form of chat in the Slack channel. These meetings
   are for project updates (showing off what you’ve been working on in documentation)
   and discussing any topics relevant to the team.
 * **Issues triage** – in the form of chat in the Slack channel. These meetings 
   are for discussing [GitHub issues](https://github.com/WordPress/Documentation-Issue-Tracker/issues):
   assigning, re-assigning, unblocking, helping assignees etc.
 * **Online Contributor Days** – in the form of conference calls over Zoom. These
   are 3 hours long, and we use them to work on GitHub issues, help new contributors
   get started, and discuss any problems contributors come across while working 
   on these issues.

**What contribution can I make after this onboarding session?**

 * Run regular meetings (including writing the meeting agenda) – [role explanation](https://make.wordpress.org/docs/handbook/get-involved/team-roles/non-project-roles/#meeting-facilitator),
   [read more](https://make.wordpress.org/docs/handbook/workflows/facilitating-weekly-meetings/)
 * Write regular meeting summary – [role explanation](https://make.wordpress.org/docs/handbook/get-involved/team-roles/non-project-roles/#note-taker-meeting-summarizer),
   [examples](https://make.wordpress.org/docs/tag/summary/)
 * Run Issues triage meetings – [role explanation](https://make.wordpress.org/docs/handbook/get-involved/team-roles/non-project-roles/#issues-triage-facilitator)
 * Write Issues triage summary – [example](https://github.com/WordPress/Documentation-Issue-Tracker/issues/819)
 * Work on any [GitHub issue](https://github.com/WordPress/Documentation-Issue-Tracker/issues)
   you like.

**How do I work with GitHub issues?**
There are two major ways to work on documentation
GitHub issues:

 * create a new issue (you can also work on it if you want)
 * work on an existing issue

When you find anything wrong with WordPress documentation (it’s out of date, missing
info, typo, dead link etc.), you can report it in our GitHub issue tracker by [opening a new issue](https://github.com/WordPress/Documentation-Issue-Tracker/issues/new/choose).
At the time of writing this, we have three templates for creating a new issue. These
templates will guide you on what information is needed for a good issue report.

 * Fix Doc Issue Report – for reporting issues with the existing documentation page.
 * New Doc Request – for proposing a new documentation page.
 * HelpHub Feedback reports – for issues reported via the HelpHub feedback form.

When you want to work on existing issues, you can browse them in a few ways:

 * the structured way – take a look at our [project boards](https://github.com/WordPress/Documentation-Issue-Tracker/projects?query=is%3Aopen)
 * the niche way – take a look at [all the labels](https://github.com/WordPress/Documentation-Issue-Tracker/labels)
   and find your niche
 * the brave way – just jump into [all the issues](https://github.com/WordPress/Documentation-Issue-Tracker/issues)
   and open the first one that looks interesting

Once you find the issue you want to work on, it is important to leave a comment 
in which you express interest in working on the issue (“I’d like to work on this”
or something similar). This is needed because GitHub doesn’t allow us to assign 
issues to a random username that is not in [WordPress organisation](https://github.com/orgs/WordPress/people).
There has to be some kind of connection between the username and the issue. If the
issue you like is already assigned to someone else, but the last comment is older
than 3-4 weeks, you can express interest in that issue as well as lack of activity
means that the issue is probably abandoned.

**Show me documentation**
WordPress documentation is split into two major parts:

 * [end-user documentation](https://wordpress.org/documentation/) – general and 
   blockBlock Block is the abstract term used to describe units of markup that, 
   composed together, form the content or layout of a webpage using the WordPress
   editor. The idea combines concepts of what in the past may have achieved with
   shortcodes, custom HTML, and embed discovery into a single consistent API and
   user experience. editor
 * [developer documentation](https://developer.wordpress.org/) – code reference,
   block editor, common APIs, themes, plugins, and advanced administration handbooks.

Team documentation is located in this handbook. Each team has their own handbook,
which is maintained by the team itself.

First published

May 19, 2023

[  Previous: Onboarding sessions](https://make.wordpress.org/docs/handbook/get-involved/onboarding-sessions/)

[  Next: Updating and creating new screenshots](https://make.wordpress.org/docs/handbook/get-involved/onboarding-sessions/updating-and-creating-new-screenshots/)