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

Shape the Blueprints Community Space #54

Closed
adamziel opened this issue Feb 29, 2024 · 2 comments
Closed

Shape the Blueprints Community Space #54

adamziel opened this issue Feb 29, 2024 · 2 comments

Comments

@adamziel
Copy link
Collaborator

adamziel commented Feb 29, 2024

The Blueprint community space should empowers the developers to explore, share, and remix WordPress configurations. Need a preconfigured Woo store? It’s there. Want to share a fancy development setups with tools like database explorer and WP-CLI? Go for it!

Here’s my best guess of the minimal set of features required to launch the initial version of w.org/blueprints.

User flows

  • Onboarding page: I learn why Blueprints are useful and what I can do with them. It’s similar to the /blocks page.
  • Browse Blueprints: I can browse and search the available Blueprints.
  • View Blueprint: I can run a Blueprint, download a blueprint, and preview its JSON contents. I can also learn who submitted it, when, how did they describe it, etc.

Contributor flows

  • Blueprint submission: I can submit a Blueprint to the directory. For simplicity, it could only accept a single Blueprint.json file with no additional assets.
  • Documentation: I can read examples, tutorials, and references about building and debugging Blueprints. This is where the developer tools would be described (for now it’s just JSON schema for code completion in VS code or PHPStorm).
  • Collaboration: I can discuss Blueprints, collaborate on them, ask for support, and report errors. This is where community forums, Trac labels, and clear error reporting guidelines come into play.

Open questions

How should Blueprint submission work?

Here’s two ideas:

  • Build a submission form on w.org. It could only have a single file/textarea field that accepts valid blueprints with no additional assets. The same form would handle updating the existing Blueprint.
  • Use a GitHub repository. Submissions would be Pull Requests and GitHub would also solve management, storage, serving (via raw.githubusercontent.com) and collaboration. It would need to be connected the Blueprints repo to the browsing experience on w.org.
@adamziel adamziel added this to the Blueprints community space milestone Feb 29, 2024
@adamziel adamziel changed the title Blueprints community space Shape Blueprints Community Space Feb 29, 2024
@adamziel adamziel changed the title Shape Blueprints Community Space Shape the Blueprints Community Space Feb 29, 2024
@adamziel
Copy link
Collaborator Author

adamziel commented Mar 6, 2024

Required developer documentation: https://github.com/WordPress/blueprints/issues/64

@adamziel
Copy link
Collaborator Author

Let's move forward with the following scope:

  • GitHub Repository as v1 of the community space. It's easy to build, provides contribution and support workflows, and is supported by Playground previews. I've started one here.
    • Design visitor workflows
    • Onboarding – Explain why Blueprints are useful and what I can do with them. I've started the main README file with that info.
    • Browse Blueprints – Currently it's an auto-generated GALLERY.md file with a list of all Blueprints available in the repo.
    • View Blueprint – The GALLERY.md contains a "preview" link and a "view source" link.
  • Design contributor workflows
    • Explain how to build a Blueprint – This is missing. Developers should have access to examples, tutorials, and references about building and debugging Blueprints. This is where the developer tools would be described (for now it’s just JSON schema for code completion in VS code or PHPStorm). GitHub issue.
    • Blueprint submission – README explains how to submit a new PR. We'll need an PR template with some guidelines and a checklist.
    • Blueprint review – Playground Maintainers will review new PRs at the beginning, document our review guidelines, and then hand off the review process to community volunteers.
    • Asking for support – README explains how to ask for support by creating a new issue. We'll need an issue template with some guidelines.
    • Getting support – Playground Maintainers will monitor new issues at the beginning and use them to inform Playground development and documentation.
    • Prepare 10 starter Blueprints to test-drive the contribution workflows and launch with some content in place. GitHub issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Done
Development

No branches or pull requests

1 participant