WordPress devhub blueprint

[carstingaxion]

I’d like to see (and maybe start working on) a blueprint that replicates the WordPress devhub for a custom plugin. As a real use-case I’d like to explore creating developer.gatherpress.org with the phpdoc-parser running against the plugin code of GatherPress.

[carstingaxion]

Hello @dmsnell ,

did you explore this dmsnell/phpdoc-parser@bda7e06 any further?

I would like to know, how things went.
I’m sorry for pinging you like this and would appreciate if you could take a minute.

Thanks Carsten

[adamziel]

This would be lovely! I've heard a local setup can be quite challenging. Although that doesn't address the devhub issue, I have some early explorations going for a GitHub-based documentation site workflow: https://github.com/adamziel/playground-docs-workflow

[dmsnell]

@carstingaxion I haven't pushed that any further along, but would love some help!

[flexseth]

There is a GitHub token required - for Composer - to make the DevHub local setup work properly, otherwise this seems feasible and helpful!

question: What happens if there are manual steps needed for a blueprint to function? 🤯

[carstingaxion]

This would be lovely! I've heard a local setup can be quite challenging.

You heard right. It’s not my first attempt and it is … challenging.

Although that doesn't address the devhub issue, I have some early explorations going for a GitHub-based documentation site workflow: https://github.com/adamziel/playground-docs-workflow

Yes this is indeed cool and could help, thank you @adamziel

Luckily this came already to my attention and is even more cool as it could help preparing a playground with the goal to create and manage demo content for a plugin or theme, that will be saved back to a given repo. I guess @ndiego is working on something similar and me too.

[carstingaxion]

@carstingaxion I haven't pushed that any further along, but would love some help!

Thank you for stopping by @dmsnell and sorry for being that late with my reaction.

I started exploring the idea at https://github.com/carstingaxion/gatherpress-devhub, which currently has 2 branches. Getting the parser to run on the GatherPress code and within the playground worked … somehow and was the first branch.

The second branch houses the absolutely not pleasing experiments or hacks to get the theme running, which didn’t worked yet. Also, but not exclusively because of the composer token @flexseth mentioned. I struggled with that too.

[ndiego]

Luckily this came already to my attention and is even more cool as it could help preparing a playground with the goal to create and manage demo content for a plugin or theme, that will be saved back to a given repo. I guess @ndiego is working on something similar and me too.

I imagine a world where most WordPress developers have their own little collection of blueprints that suit their specific needs.

[carstingaxion]

I imagine a world where most WordPress developers have their own little collection of blueprints that suit their specific needs.

I imagine a world where most WordPress developers share a common collection of blueprints that suits typical needs.

[carstingaxion]

Making a well-known, nice designed and well structured documentation (website) available to every plugin author with the help of playground could be our take on number 5 of @m|s birthday opinions.

Every plugin and theme should have all the infrastructure that we use to build WordPress itself—version control, bug trackers, forums, documentation, internationalization, chat rooms, P2, and easy pathways for contribution and community. We shouldn’t be uploading ZIPs in 2024!