Summary for HelpHub meeting 11 March 2019

Attendance

@milana_cap @atachibana @daveryan @iviolini @kartiks16 @jessecowens @softservenet @dinamiko @nullbyte @kafleg @kenshino @audrasjb attended

Development (Phase 1.5)

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 be the repository owner. https://github.com/ -> TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/.: @milana_cap is collating issues that need moving towards Trac. We’re making sure that issues related to the portions of HelpHub that are committed to 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/ are tracked on Meta.Trac as patches would have to be provided there.

We also now have a proper slackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel #meta-helphub to discuss HelpHub development.

A regular bug scrub (perhaps once per month) will likely be planned and @milana_cap & @clorith will work out an appropriate time.

The GitHub repository will still be used for Phase 2 (working out code pieces that are not yet committed to WordPress.org) and the staging environmentStaging Environment A staging environment is a non-production copy of your site. This is a private place to build the site -- design, copy, and code -- until your client approves it for production or live. Sometimes used in addition to, or as a Development Environment. wp-helphub.com will accommodate all code staging work. The repository has also been transferred to the WordPress Team – with the original team keeping autonomy on the repository.

Content (Phase 1.5)

We’re still working on migrating all WordPress version articles from Codex to HelpHub. So far about 90% of the articles have been migrated (props to @atachibana @kartikshukla @jarretc @subrataemfluence and @audrasjb)

The coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. team has already been using HelpHub to publish release notes since WordPress 5.0

Progress is being tracked via this Google Sheet – while migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. is mostly done, @atachibana and team are working on the review and publishing process.

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 Docs

@milana_cap, @clorith and a great team of volunteers helped copy over the block editor docs contributed from the peeps at Automattic (WordPress.comWordPress.com An online implementation of WordPress code that lets you immediately access a new WordPress environment to publish your content. WordPress.com is a private company owned by Automattic that hosts the largest multisite in the world. This is arguably the best place to start blogging if you have never touched WordPress before. https://wordpress.com/).

Existing docs that refer to classic editor will be cloned and new block editor docs will be created and prefixed with -block-editor

  • https://wordpress.org/support/article/pages-add-new-screen/ will refer to the old way of adding new pages
  • https://wordpress.org/support/article/pages-add-new-screen-block-editor will refer to the post WordPress 5.0 way of adding new pages

The old docs will be kept and the new docs will be linked straight from HelpHub’s homepage.

@daveryan will be working alongside @atachibana to determine if there are any more key block editor (GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/) docs to be written. (Basically we should be providing enough information to help people get to learn the block editor)

The new block editor user docs are available here – https://wordpress.org/support/category/block-editor/

Design

@iviolini is taking some time to get familiar with the needs of HelpHub. The WordPress versions require a proper archive page and that will likely be one of the first tasks to be worked on.

Localisation Plan

We’re still working out the technical aspects of the plan. But as it seems, the Community Team requires very similar work done to their Community Handbooks.

So we’re looking at a combined tech approach across Docs, MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress., Polyglots and Community Teams. (We have some peeps from Multilingual Press who are going to chime in too)

@milana_cap is trying to convene a Zoom call to get all related parties together and an appropriate time is being decided on this Doodle. Do fill it in if you’re interested – particularly if you are able to provide technical expertise and time to work our the issues.

You can read what went on in the meeting via Slack logs.