Missing "blueprints" directory in the blueprint JSON file path

[vladutilie]

Issue Description

Hello! I have noticed the "blueprints" directory is missing from the blueprint.json file path in the last section of the page.

URL of the Page with the Issue

https://developer.wordpress.org/plugins/wordpress-org/previews-and-blueprints

Section of Page with the issue

Committing a Blueprint to Subversion

Why is this a problem?

If the blueprint.json is not in the blueprint directory, it will not work.

Suggested Fix

The blueprint.json file path should be assets/blueprints/blueprint.json as described in the docs above.

Regards,
Vlad

[github-actions]

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

[flexseth]

/assign

[github-actions]

Hey @flexseth, thanks for your interest in this issue! 🍪🍪🍪
If you have any questions, do not hesitate to ask them in our #docs Slack channel.
Enjoy and happy contributing ❤️

[sc0ttkclark]

This one hit me, I read through everything and finally realized some other area and another page referenced a "blueprints" directory of the "assets" directory and I put all the pieces together finally!

[flexseth]

This one hit me, I read through everything and finally realized some other area and another page referenced a "blueprints" directory of the "assets" directory and I put all the pieces together finally!

Nice, @sc0ttkclark!

We're working on an overhaul of the documentation now.

• Playground Documentation overhaul wordpress-playground#772

[sc0ttkclark]

If it's quick and possible, it would be great to just tweak that text at the bottom to prevent confusion for people updating their plugins for the WP 6.5 release and them seeing the notice on .org that points them there.

[sc0ttkclark]

As noted in the original issue summary here, it's this one and I've linked it to the heading the wrong path reference is under: https://developer.wordpress.org/plugins/wordpress-org/previews-and-blueprints/#committing-a-blueprint-to-subversion

/assets/blueprint.json should say /assets/blueprints/blueprint.json

[flexseth]

/assets/blueprint.json should say /assets/blueprints/blueprint.json

I see, I made a PR about this, but it was bundled with another PR because I'm a newb.

• Updated documentation in Plugins Handbook developer-plugins-handbook#6

Tuesday we have a docs meeting, should be able to get some eyes on it.

/review

[sc0ttkclark]

Awesome, thank you so much @flexseth -- hopefully in the mean time people will find their way to the right path without losing too much time in SVN land trying to figure out why it's not working like I did 😂

[flexseth]

This has been updated via PR, but isn't updated yet. It's possible there's some SVN magic that needs to happen for it to be updated in the Plugins Handbook. Asked some questions, we'll see what's up

[flexseth]

Merged, if you all run into any other issues please raise them in either

• Documentation Issues Tracker repo
• or the Playground issues

Thanks again for reporting, this was a critically important update!