Contributing to WordPress

In this article for WPTavern Chris Van Patten shares his experience with contributing to the Gutenberg project. The original article was a Twitter thread, but it’s nicer reading a proper long form piece.


For Chris, the experience of contributing to Gutenberg has been great, however I am not convinced it’s as straightforward (for everyone) as he makes out.

I’ve done some of the same things Chris has done, although not to the same degree. I’ve filed Gutenberg bug reports, and submitted some (CSS) code through pull requests. And my experience has been quite different.

Chris mentions this towards the end of the thread but the big advantage that he has is the privilege to have the time and capacity to do what he’s done. Any time he has spent contributing towards Gutenberg will have eaten into his time to earn a living, or his leisure time, or family time, or whatever. Any time he spends on Gutenberg means less time for something else.

Clearly this isn’t a problem for Chris, and it wasn’t the point of the Twitter thread (which I took to be “it’s not as hard as you think”), but it has to be acknowledged. Chris is an experienced web developer who had the time to spend contributing to, and indirectly learning, Gutenberg. Not everyone has that freedom.

Anybody who wants to work with Gutenberg beyond building themes that support the default blocks (which is pretty straight forward if you use the Block Unit Test plugin) will have to spend some time learning how Gutenberg works.

Even if you don’t learn React, which in my opinion is not required for basic use cases, you will still need to learn a brand new collection of API’s.

For example I wanted to add block style variations to one of my themes, and was given the javascript code required, but at the time it wasn’t documented – and the docs still don’t mention where to put the js (I’m not convinced I’ve done it the ‘correct’ way – but it works).

Which raises a whole side issue of documentation and education, which are currently lacking. If you want to know more about Javascript for Gutenberg then I have heard good things about Javascript for WP.

I think the big issue I have with Gutenberg development is simply that it’s so different to classic WordPress. It’s not PHP. It requires build tools. It uses a new javascript library that’s very different to anything we’ve used before.

One of these things at a time would be more manageable, but all at once is a lot of change, and I suspect that contributes to the dislike of the project.

Of course none of these things are insurmountable, I have no problem using build tools or javascript, but React is brand new to me. I’ve now started learning React (about time right?) but it will be a while before I am as comfortable with React as I am with vanilla Javascript.

Anyway TL:DR; if you want to develop for Gutenberg you can, and it’s not that difficult. But it will probably take some time to get up to speed.

Was it good/ useful/ a load of old rubbish? Let me know on Mastodon, or BlueSky (or Twitter X if you must).

Link to this page

Thanks for reading. I'd really appreciate it if you'd link to this page if you mention it in your newsletter or on your blog.

WordPress News

The latest WordPress updates from the WPBriefs Podcast.

Related Posts

30 Jul 2018

Learning ReactJS for Designers

JavaScript is simple, or at least it used to be. If you’ve done any programming, and you know how to use Google then you can program in JavaScript. Of course, to make it more powerful we have to complicate things.We...
11 Jan 2019

Should Everyone Learn Javascript Deeply?

I’ve been thinking about writing about learning javascript for a while now, but seeing Brad Frost and Heydon Pickerings articles appear over the last couple of weeks has really made me consider my approach to the technology.Ever since Matt suggested...
04 Jun 2020

Learning is hard, and so is React

This tweet from Kelly Vaughn caught my eye recently. It came a couple of days after another tweet from Brad Touesnard who said “I have run out of empathy for people whining about having to learn React”.I really sympathise with...
27 May 2013

WordPress: 10 Years Young, What Does The Future Hold?

WordPress is now 10 years old. I started using wordpress 9 years ago – which means I joined the WordPress community early on. The reason I chose WordPress is simply because of the fabled 5 minute install process – I...
31 Aug 2009

Learning to Learn: how to improve yourself

I have a massive appetite for learning. I am always reading books and blogs to try to better understand the things I want to do. Design, programming, marketing, copy-writing, I constantly strive to improve.On the web your skill set needs...
20 Jul 2018

GutenReady for the Gutenpocalypse – Educating Gutenberg

It was WPCampus last weekend, an education focused WordPress conference. There’s a lot of talks about using WordPress in Universities and other educational establishments – but there’s also a lot of more traditional WordCamp subjects.One presentation in particular caught my...