Making WordPress.org

Opened 2 years ago

Last modified 4 weeks ago

#6223 new enhancement

Provide information about committing theme updates directly to SVN

Reported by: dufresnesteven's profile dufresnesteven Owned by:
Milestone: Priority: normal
Component: Theme Review Keywords:
Cc:

Description

The theme directory now allows authors to make updates directly to a theme via SVN. The handbook has been updated with information on how to do it (https://developer.wordpress.org/themes/releasing-your-theme/updating-your-theme/#uploading-your-themes-using-svn-on-macos).

There are a few more interactions where theme updates are mentioned but don't mention direct SVN updates. I think it would benefit theme authors to include information or link to information about committing via SVN.

Upload Page:

How to upload a theme update
If you are uploading a theme update, simply increase the version inside of style.css and upload the theme-name.zip file again, just like you do with a new theme.

Confirmation Email:

** Theme Updates **
You can update your theme any time and it will be added to the ticket. You can do so by bumping up your theme's version number in your style.css and uploading a new ZIP file.
<https://wordpress.org/themes/getting-started/>

Theme goes live, confirmation email:

We currently don't mention anything about updating code.

Congratulations, your new theme {theme} is now available to the public at {theme url}.

Any feedback items are at https://themes.trac.wordpress.org/ticket/{ticket-number}.

The WordPress.org Themes Team
https://make.wordpress.org/themes

Change History (8)

#1 @dufresnesteven
22 months ago

Upload Page:

Current:
If you are uploading a theme update, simply increase the version inside of style.css and upload the theme-name.zip file again, just like you do with a new theme.

Proposal:
If you are uploading a theme update, simply increase the version inside of style.css and upload the theme-name.zip file again, just like you do with a new theme. Alternatively, you can make updates using subversion (SVN). <a href="https://developer.wordpress.org/themes/releasing-your-theme/updating-your-theme">Read more about theme updates</a>.

Code Ref https://github.com/WordPress/wordpress.org/blob/55a1006c325abcdb387970a43e67db65e7cd0421/wordpress.org/public_html/wp-content/themes/pub/wporg-themes/page-upload.php#L47_

#2 @dufresnesteven
22 months ago

Confirmation Email:

Current:
You can update your theme any time and it will be added to the ticket. You can do so by bumping up your theme's version number in your style.css and uploading a new ZIP file.
<https://wordpress.org/themes/getting-started/>

Proposal:
You can update your theme any time and it will be added to the ticket. You can do so by bumping up your theme's version number in your style.css and uploading a new ZIP file, or by using subversion (SVN).
<https://wordpress.org/themes/getting-started/>

Code Ref:
https://github.com/WordPress/wordpress.org/blob/55a1006c325abcdb387970a43e67db65e7cd0421/wordpress.org/public_html/wp-content/plugins/theme-directory/class-wporg-themes-upload.php#L1514

#3 @dufresnesteven
22 months ago

Theme goes live, confirmation email:

The plugin directory adds a number of useful links in the confirmation email. I think we can use that approach. I'm not sure what links would be the best, but this example includes the default handbook page and theme update documentation.

Current:

Congratulations, your new theme {theme name} is now available to the public at {theme url}.

Any feedback items are at https://themes.trac.wordpress.org/ticket/{ticket-number}.

Proposal:

Congratulations, your new theme {theme name} is now available to the public at {theme url}.

Any feedback items are at https://themes.trac.wordpress.org/ticket/{ticket-number}.

Theme Handbook
https://developer.wordpress.org/themes

Making Theme Updates
https://developer.wordpress.org/themes/releasing-your-theme/updating-your-theme/

Code Ref:
https://github.com/WordPress/wordpress.org/blob/55a1006c325abcdb387970a43e67db65e7cd0421/wordpress.org/public_html/wp-content/plugins/theme-directory/theme-directory.php#L576

This ticket was mentioned in Slack in #themereview by kafleg. View the logs.


4 weeks ago

#5 @kafleg
4 weeks ago

I like the idea of providing more information about how to update the release. I think meta team can handle this part.

#6 @dd32
4 weeks ago

@kafleg Confirmation from the Themes team as to the wording of the messages would be appreciate :)

#7 @kafleg
4 weeks ago

Thank you for looking in to this @dd32

I'll confirm from the themes team and get back to you ASAP.

#8 @kafleg
4 weeks ago

We checked and the message is fine. We can update the template with this wording.

Note: See TracTickets for help on using tickets.