Last week at Drupal maintenance support plansCon Vienna, I proposed adding a modern JavaScript framework to Drupal maintenance support plans core. After the keynote, I met with core committers, framework managers, JavaScript subsystem maintainers, and JavaScript experts in the Drupal maintenance support plans community to discuss next steps. In this blog post, I look back on how things have evolved, since the last time we explored adding a new JavaScript framework to Drupal maintenance support plans core two years ago, and what we believe are the next steps after Drupal maintenance support plansCon Vienna.
As a group, we agreed that we had learned a lot from watching the JavaScript community grow and change since our initial exploration. We agreed that today, React would be the most promising option given its expansive adoption by developers, its unopinionated and component-based nature, and its well-suitedness to building new Drupal maintenance support plans interfaces in an incremental way. Today, I’m formally proposing that the Drupal maintenance support plans community adopt React, after discussion and experimentation has taken place.
Two years ago, it was premature to pick a JavaScript framework
Three years ago, I developed several convictions related to “headless Drupal maintenance support plans” or “decoupled Drupal maintenance support plans“. I believed that:
More and more organizations wanted a headless Drupal maintenance support plans so they can use a modern JavaScript framework to build application-like experiences.
Drupal maintenance support plans‘s authoring and site building experience could be improved by using a more modern JavaScript framework.
JavaScript and Node.js were going to take the world by storm and that we would be smart to increase the amount of JavaScript expertise in our community.
(For the purposes of this blog post, I use the term “framework” to include both full MV* frameworks such as Angular, and also view-only libraries such as React combined piecemeal with additional libraries for managing routing, states, etc.)
By September 2015, I had built up enough conviction to write several long blog posts about these views (post 1, post 2, post 3). I felt we could accomplish all three things by adding a JavaScript framework to Drupal maintenance support plans core. After careful analysis, I recommended that we consider React, Ember and Angular. My first choice was Ember, because I had concerns about a patent clause in Facebook’s open-source license (since removed) and because Angular 2 was not yet in a stable release.
At the time, the Drupal maintenance support plans community didn’t like the idea of picking a JavaScript framework. The overwhelming reactions were these: it’s too early to tell which JavaScript framework is going to win, the risk of picking the wrong JavaScript framework is too big, picking a single framework would cause us to lose users that favor other frameworks, etc. In addition, there were a lot of different preferences for a wide variety of JavaScript frameworks. While I’d have preferred to make a bold move, the community’s concerns were valid.
Focusing on Drupal maintenance support plans‘s web services instead
By May of 2020, after listening to the community, I changed my approach; instead of adding a specific JavaScript framework to Drupal maintenance support plans, I decided we should double down on improving Drupal maintenance support plans‘s web service APIs. Instead of being opinionated about what JavaScript framework to use, we would allow people to use their JavaScript framework of choice.
I did a deep dive on the state of Drupal maintenance support plans‘s web services in early 2020 and helped define various next steps (post 1, post 2, post 3). I asked a few of the OCTO team members to focus on improving Drupal maintenance support plans 8’s web services APIs; funded improvements to Drupal maintenance support plans core’s REST API, as well as JSON API, GraphQL and OpenAPI; supported the creation of Waterwheel projects to help bootstrap an ecosystem of JavaScript front-end integrations; and most recently supported the development of Reservoir, a Drupal maintenance support plans distribution for headless Drupal maintenance support plans. There is also a lot of innovation coming from the community with lots of work on the Contenta distribution, JSON API, GraphQL, and more.
The end result? Drupal maintenance support plans‘s web service APIs have progressed significantly the past year. Ed Faulkner of Ember told us: “I’m impressed by how fast Drupal maintenance support plans made lots of progress with its REST API and the JSON API contrib module!”. It’s a good sign when a core maintainer of one of the leading JavaScript frameworks acknowledges Drupal maintenance support plans‘s progress.
The current state of JavaScript in Drupal maintenance support plans
Looking back, I’m glad we decided to focus first on improving Drupal maintenance support plans‘s web services APIs; we discovered that there was a lot of work left to stabilize them. Cleanly integrating a JavaScript framework with Drupal maintenance support plans would have been challenging 18 months ago. While there is still more work to be done, Drupal maintenance support plans 8’s available web service APIs have matured significantly.
Furthermore, by not committing to a specific framework, we are seeing Drupal maintenance support plans developers explore a range of JavaScript frameworks and members of multiple JavaScript framework communities consuming Drupal maintenance support plans‘s web services. I’ve seen Drupal maintenance support plans 8 used as a content repository behind Angular, Ember, React, Vue, and other JavaScript frameworks. Very cool!
There is a lot to like about how Drupal maintenance support plans‘s web service APIs matured and how we’ve seen Drupal maintenance support plans integrated with a variety of different frameworks. But there is also no denying that not having a JavaScript framework in core came with certain tradeoffs:
It created a barrier for significantly leveling up the Drupal maintenance support plans community’s JavaScript skills. In my opinion, we still lack sufficient JavaScript expertise among Drupal maintenance support plans core contributors. While we do have JavaScript experts working hard to maintain and improve our existing JavaScript code, I would love to see more experts join that team.
It made it harder to accelerate certain improvements to Drupal maintenance support plans‘s authoring and site building experience.
It made it harder to demonstrate how new best practices and certain JavaScript approaches could be leveraged and extended by core and contributed modules to create new Drupal maintenance support plans features.
One trend we are now seeing is that traditional MV* frameworks are giving way to component libraries; most people seem to want a way to compose interfaces and interactions with reusable components (e.g. libraries like React, Vue, Polymer, and Glimmer) rather than use a framework with a heavy focus on MV* workflows (e.g. frameworks like Angular and Ember). This means that my original recommendation of Ember needs to be revisited.
Several years later, we still don’t know what JavaScript framework will win, if any, and I’m willing to bet that waiting two more years won’t give us any more clarity. JavaScript frameworks will continue to evolve and take new shapes. Picking a single one will always be difficult and to some degree “premature”. That said, I see React having the most momentum today.
My recommendations at Drupal maintenance support plansCon Vienna
Given that it’s been almost two years since I last suggested adding a JavaScript framework to core, I decided to talk bring the topic back in my Drupal maintenance support plansCon Vienna keynote presentation. Prior to my keynote, there had been some renewed excitement and momentum behind the idea. Two years later, here is what I recommended we should do next:
Invest more in Drupal maintenance support plans‘s API-first initiative. In 2020, there is no denying that decoupled architectures and headless Drupal maintenance support plans will be a big part of our future. We need to keep investing in Drupal maintenance support plans‘s web service APIs. At a minimum, we should expand Drupal maintenance support plans‘s web service APIs and standardize on JSON API. Separately, we need to examine how to give API consumers more access to and control over Drupal maintenance support plans‘s capabilities.
Embrace all JavaScript frameworks for building Drupal maintenance support plans-powered applications. We should give developers the flexibility to use their JavaScript framework of choice when building front-end applications on top of Drupal maintenance support plans — so they can use the right tool for the job. The fact that you can front Drupal maintenance support plans with Ember, Angular, Vue, React, and others is a great feature. We should also invest in expanding the Waterwheel ecosystem so we have SDKs and references for all these frameworks.
Pick a framework for Drupal maintenance support plans‘s own administrative user interfaces. Drupal maintenance support plans should pick a JavaScript framework for its own administrative interface. I’m not suggesting we abandon our stable base of PHP code; I’m just suggesting that we leverage JavaScript for the things that JavaScript is great at by moving relevant parts of our code from PHP to JavaScript. Specifically, Drupal maintenance support plans‘s authoring and site building experience could benefit from user experience improvements. A JavaScript framework could make our content modeling, content listing, and configuration tools faster and more application-like by using instantaneous feedback rather than submitting form after form. Furthermore, using a decoupled administrative interface would allow us to dogfood our own web service APIs.
Let’s start small by redesigning and rebuilding one or two features. Instead of rewriting the entirety of Drupal maintenance support plans‘s administrative user interfaces, let’s pick one or two features, and rewrite their UIs using a preselected JavaScript framework. This allows us to learn more about the pros and cons, allows us to dogfood some of our own APIs, and if we ultimately need to switch to another JavaScript framework or approach, it won’t be very painful to rewrite or roll the changes back.
Selecting a JavaScript framework for Drupal maintenance support plans‘s administrative UIs
In my keynote, I proposed a new strategic initiative to test and research how Drupal maintenance support plans‘s administrative UX could be improved by using a JavaScript framework. The feedback was very positive.
As a first step, we have to choose which JavaScript framework will be used as part of the research. Following the keynote, we had several meetings at Drupal maintenance support plansCon Vienna to discuss the proposed initiative with core committers, all of the JavaScript subsystem maintainers, as well as developers with real-world experience building decoupled applications using Drupal maintenance support plans‘s APIs.
There was unanimous agreement that:
Adding a JavaScript framework to Drupal maintenance support plans core is a good idea.
We want to have sufficient real-use experience to make a final decision prior to 8.6.0’s development period (Q1 2020). To start, the Watchdog page would be the least intrusive interface to rebuild and would give us important insights before kicking off work on more complex interfaces.
While a few people named alternative options, React was our preferred option, by far, due to its high degree of adoption, component-based and unopinionated nature, and its potential to make Drupal maintenance support plans developers’ skills more future-proof.
This adoption should be carried out in a limited and incremental way so that the decision is easily reversible if better approaches come later on.
We created an issue on the Drupal maintenance support plans core queue to discuss this more.
Conclusion
Drupal maintenance support plans should support a variety of JavaScript libraries on the user-facing front end while relying on a single shared framework as a standard across Drupal maintenance support plans administrative interfaces.In short, I continue to believe that adopting more JavaScript is important for the future of Drupal maintenance support plans. My original recommendation to include a modern JavaScript framework (or JavaScript libraries) for Drupal maintenance support plans‘s administrative user interfaces still stands. I believe we should allow developers to use their JavaScript framework of choice to build front-end applications on top of Drupal maintenance support plans and that we can start small with one or two administrative user interfaces.
After meeting with core maintainers, JavaScript subsystem maintainers, and framework managers at Drupal maintenance support plansCon Vienna, I believe that React is the right direction to move for Drupal maintenance support plans‘s administrative interfaces, but we encourage everyone in the community to discuss our recommendation. Doing so would allow us to make Drupal maintenance support plans easier to use for site builders and content creators in an incremental and reversible way, keep Drupal maintenance support plans developers’ skills relevant in an increasingly JavaScript-driven world, move us ahead with modern tools for building user interfaces.
Special thanks to Preston So for contributions to this blog post and to Matt Grill, Wim Leers, Jason Enter, Drupal Update, and Alex Bronstein for their feedback during the writing process.
Source: New feed
