Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Theme Handbook Overhaul (Tracking Ticket) #816

Open
70 of 96 tasks
justintadlock opened this issue May 1, 2023 · 10 comments
Open
70 of 96 tasks

Theme Handbook Overhaul (Tracking Ticket) #816

justintadlock opened this issue May 1, 2023 · 10 comments
Assignees
Labels
developer documentation (DevHub) Improvements or additions to developer documentation themes Issues for Theme Developer Handbook

Comments

@justintadlock
Copy link

justintadlock commented May 1, 2023

In April, there was a proposal to overhaul the WordPress Theme Handbook with a new structure and learning pathways for theme creators. April 28 was the deadline for feedback on the proposal. After two meetings and an open discussion, we have an outline that we can begin working from.

To reference the progress on this project, visit the following docs and posts:

Tracking Issues

This is an overall tracking ticket for the project. The following list should be updated to link to specific tickets as they are created. The list may also be amended as this project progresses. Note that some pages already exist and merely need to be moved or potentially updated.

@justintadlock justintadlock added developer documentation (DevHub) Improvements or additions to developer documentation themes Issues for Theme Developer Handbook labels May 1, 2023
@github-actions
Copy link

github-actions bot commented May 1, 2023

Heads up @kafleg @carolinan @TeBenachi - the "themes" label was applied to this issue.

@zzap
Copy link
Member

zzap commented May 1, 2023

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

@javiercasares
Copy link
Collaborator

@t-hamano
Copy link

t-hamano commented Aug 30, 2024

It would be great if the theme handbook pages were managed in a GitHub repository.

The Japanese community has published Japanese versions of some handbooks, but the flow varies greatly depending on whether the original repository is managed on GitHub or not.

  • If it is managed on GitHub (such as the plugin handbook): Fork the repository, comment out the original text, and add the Japanese translation below it (example). This makes it easier to detect differences when merging updates made upstream.
  • If it is not managed on GitHub: Use a tool called wp-handbook-converter to parse the handbook pages and convert them to markdown. This mostly works, but manual adjustments may be required.

If there is a GitHub repository, I would be happy to contribute when I have time.

@justintadlock
Copy link
Author

@t-hamano I'd love that too. Here's the relevant ticket: https://meta.trac.wordpress.org/ticket/7520

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
developer documentation (DevHub) Improvements or additions to developer documentation themes Issues for Theme Developer Handbook
Projects
None yet
Development

No branches or pull requests

6 participants