Welcome to the official home of the WordPress Documentation Team.
This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.
Want to get involved?
Start here to find out more about what we do and how to contribute:
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHubGitHub 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 be the repository owner. https://github.com/
Weekly meetings
Join our discussions of documentation issues here on the blog and on Slack.
Development is being managed through GitHub. Guidelines for development are fleshed out in the repo readme, but if you would like to get involved there then please pingPingThe act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” @milana_cap (zzap in SlackSlackSlack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/.) in the #docs channel on Slack.
Like any other website, HelpHub requires design and development work. Your contributions in these areas can assure that HelpHub is as performant and usable as possible.
To facilitate the work of many volunteer developers, HelpHub uses Varying Vagrant Vagrants (VVV) so developers can easily create a local WordPress environment. Follow the steps in this section to create your development environment and contribute code to the HelpHub project.
First thing to start contributing is to set up your local environment. You can choose whichever environment works for you, the main thing is to have fresh WordPress install. You can also follow our VVV setup below.
Once you have WordPress install in your local environment ready, fork GitHub repository, clone your fork to local environment and import database and widgetWidgetA WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. settings.
Follow instructions in CONTRIBUTING.md file. If you run into problems, get error messages or find the instructions incomplete or incorrect then this is the opportunity for your first contribution.
If you know how to fix the problem and what’s missing or is incorrect, edit document in your fork and create pull request to HelpHub repo. Do this even if you are not sure if your fix is completely correct or applicable to every OS. We will review it and ask for changes if needed.
If you don’t know how to fix the problem, please ask for help in #docs channel or send direct message to @milana_cap (zzap in Slack). Once the problem is fixed it would be great if you could update the GitHubGitHubGitHub 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 be the repository owner. https://github.com/ document.
The objectives of the procedure described here are to:
create a local WordPress installation where you can do development and design work and
contribute that work to the HelpHub project.
This process uses Vagrant, which allows you to create a sandboxed development environment on your computer. Vagrant provides an environment that isn’t specific to WordPress (or any other application), so you’ll also use VVV to configure your Vagrant environment specifically for WordPress development.
VVV is now running locally, which means you can access several versions of the WordPress application and the WordPress coreCoreCore is the set of software required to run WordPress. The Core Development Team builds WordPress. source code. Click the links below to explore your VVV environment.
http://vvv.test Your VVV home page. Links to local dev sites and admin tools.
You can use your IDE to change any of the files in the environment, developing features and bugfixes and testing them locally. To learn how to contribute your changes back to the HelpHub project, see the next section.
If you’re interested in contributing to HelpHub as a developer or designer, you can assign yourself an issue from the GitHub repo and contribute code to fix a bug or add a feature.
Fork the project. Create a fork of the HelpHub source code from https://github.com/Kenshino/HelpHub. This fork is where you’ll commit any changes that you intend to contribute to the HelpHub project.
Create a local environment. See “Installing and Configuring VVV” above.
Backup wp-content. In your development environment, rename wp-content to something. Later, you will need the current theme contents to access the Administration Screen. For example, if you have installed VVV under ~/vagrant-local. $ cd ~/vagrant-local/www/wordpress-develop/public_html/src $ mv wp-content wp-content-original
Clone your fork locally. Clone your fork of the HelpHub repo as a wp-content. $ git clone https://github.com/[githubusername]/HelpHub.git wp-content
Copy back your current theme. If your environment is new one, it must be “Twenty Seventeen”. $ cp -r wp-content-original/themes/twentyseventeen wp-content/themes/twentyseventeen
Import the HelpHub data. HelpHub’s source code includes a database export (helphub.wordpress.{DATE}.xml). Import this data into your local WordPress site to add a snapshot of the content. For more detail info, refer CONTRIBUTING.md in the GitHub repo.
Make your changes in VVV. Develop and test your feature or bugfix in your VVV clone.
Commit your changes. Commit your revised code to your HelpHub fork.
Create a pull request. Request to merge your commits into the HelpHub repo from your fork.
To make the site usable, and to keep our codebase manageable, we’re committed to these guidelines and standards.
AccessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) HelpHub should be usable by all, including users with physical and cognitive disabilities, and those using assistive technologies. Our work must not create any obstacles or limit the access of these users. We embrace tools and processes that facilitate creating an accessible HelpHub, and we value design and testing that maximize accessiblity.
Responsive Design We’re committed to designing, building and maintaining a site that is usable on devices of varying sizes and platforms.
Standardized Code We adhere to the WordPress Coding Standards. We aim to create code that is consistent and readable. The HTMLHTMLHTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites., CSSCSSCSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site., PHPPHPPHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. http://php.net/manual/en/intro-whatis.php. and JavascriptJavaScriptJavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com/. created by the WordPress community should always follow the appropriate coding standard.