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] Getting Started > Quick-start guide #878

Closed
Tracked by #816 ...
justintadlock opened this issue Jun 19, 2023 · 8 comments
Closed
Tracked by #816 ...

[Theme Handbook Overhaul] Getting Started > Quick-start guide #878

justintadlock opened this issue Jun 19, 2023 · 8 comments
Assignees
Labels
developer documentation (DevHub) Improvements or additions to developer documentation new document Requests for new page/article. [Status] Done Issue is completed themes Issues for Theme Developer Handbook

Comments

@justintadlock
Copy link

This ticket is a part of #816 and will be used for creating new page titled "Quick-start guide" under Chapter 1: Getting Started.

I will draft the content for the new page in a Google Doc: https://docs.google.com/document/d/1jThdDosfY9NG-A-0N-azkJg0XR2wjwszYof5UnMm3FE/edit?usp=sharing

Some early thoughts:

  • I'll likely incorporate some of the content from the existing Theme Development Examples doc into this one. This page was not included in the new outline, but we should keep as much of that content as needed.
  • I'm probably going to lean into using TT3 and the Create Block Theme plugin for this. This way, there's not really any coding involved and the reader can "build" a theme quickly. Then, we can really start diving more into code in the next chapter.
@justintadlock justintadlock added developer documentation (DevHub) Improvements or additions to developer documentation new document Requests for new page/article. themes Issues for Theme Developer Handbook labels Jun 19, 2023
@justintadlock justintadlock self-assigned this Jun 19, 2023
@github-actions
Copy link

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

@justintadlock
Copy link
Author

I've almost completed the first draft of this. The remaining section is on exporting a theme with the Create Block Theme plugin.

I'll be on vacation until July 3, so if anyone wants to draft out that section in the meantime, let me know. I'll be happy to add editing access for you. Otherwise, I'll wrap it up when I return.

@kafleg
Copy link
Member

kafleg commented Jun 26, 2023

It's detailed and precise. I don't want to get involved in the writing and make it bad. ;) I'll help to add in the site when we start doing that.

Also checked the draft. Some words are quite tough for me, I think we need to use 3 grade standard words to make it even simpler to read it.

@justintadlock
Copy link
Author

I've completed the final section of this post with the addition of steps on how to export with Create Block Theme.

@kafleg - Feel free to suggest any word changes in the doc. I'm happy to make changes where needed.

@carolinan
Copy link
Collaborator

Looks OK to me, pending screenshots.

We should avoid using yoursite.com as an example because this is an existing commercial third-party site.

@justintadlock
Copy link
Author

justintadlock commented Nov 2, 2023

This doc is now a draft in the Theme Handbook: https://developer.wordpress.org/wp-admin/post.php?post=149320&action=edit

Note that I've updated all of the screenshots to use Twenty Twenty-Four since it will be released before this doc goes live.

Edit: The screenshots leave out yoursite.com too (mentioned above).

@kafleg
Copy link
Member

kafleg commented Nov 21, 2023

With the new images, the content is even better. Thank you and LGTM.

@justintadlock
Copy link
Author

@github-actions github-actions bot added the [Status] Done Issue is completed label Nov 21, 2023
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 new document Requests for new page/article. [Status] Done Issue is completed themes Issues for Theme Developer Handbook
Projects
None yet
Development

No branches or pull requests

3 participants