Problem/Motivation

Currently XB is not working with Drupal CMS so we need to update the docs to use D10 standard profile for now.

It will be switched to D11 when this is unblocked:

#3471097: Switch SDDS to D11 components module once it's available

Or we remove the dependency on the components module:

#3469985: Reconcile components module vs SDC namespaces for SDDS includes/embeds

Steps to reproduce

Proposed resolution

Update docs to use D10 standard profile and D10 modules and themes.

Remaining tasks

User interface changes

API changes

Data model changes

Comments

kristen pol created an issue. See original summary.

kristen pol’s picture

See instructions from Simon Ramsay in Slack as well for XB install.

kristen pol’s picture

Priority: Normal » Major

Bumping priority now that the XB team wants us to focus on using D11 standard profile rather than Starshot / Drupal CMS.

kristen pol’s picture

Assigned: kristen pol » Unassigned
Priority: Major » Critical
Status: Needs work » Needs review

This has been completely refactored and simplified. It's working for me but needs more eyes.

https://www.drupal.org/community-initiatives/starshot-demo-design-system...

kristen pol’s picture

Title: Update SDDS development guide to use standard Drupal 11 profile » Update SDDS development guide to use standard Drupal 11 profile and XB
Issue summary: View changes

Update title and revise tasks.

kristen pol’s picture

Note that the XB part is just installing it and making sure it shows up. It is not testing the theme components with it. That needs to be in the testing guide which still needs to happen and is waiting on some more working on our side and the XB side.

#3464543: Create SDDS project testing guide

kristen pol’s picture

Assigned: Unassigned » jacobadeutsch

Assigning to Jacob for review.

sea2709’s picture

The documentation is shorter :-)

There is one thing we might need to pay more attention, in `composer.json` of the demo_design_system theme https://git.drupalcode.org/project/demo_design_system/-/blob/1.0.x/compo..., it requires some modules

  • Components
  • Field Group
  • Focal Point
  • etc.

These modules are included in Drupal CMS, but not in D11. I think missing these modules might break some features in the theme, and I don't see the inserting dummy data feature in the theme settings, probably because of the missing modules.

kristen pol’s picture

Thanks!

Ah shoot... I guess I need to remove from composer.json... slammed today though o_O

The dummy content stuff was intentionally removed because the sitebuilding stuff that's in CT isn't relevant for the XB demo and it's not ideal to have those extra modules (and some aren't D11 compatible). The config for the extra modules was moved to optional per:

#3465047: Remove unnecessary dependencies before DrupalCon Barcelona

But, I want to make sure that those extra modules aren't getting added...

@sea2709 do you have time on your local to test removing from composer and seeing how it goes? If it works okay, then an MR here or on that issue ^ would be appreciated! :)

kristen pol’s picture

Jacob is also reviewing.

Some notes based on things that have been going on in Slack and in other issues:

  1. We moved back to D10 because of using the components module that doesn't have a D11 release
  2. To remove the components module dependency, we'd have to use SDC namespaces which would break Storybook
  3. There is an open question to the XB team on if they want the components module gone
  4. When following the current dev guide steps, you will get XB errors due to arrays in the SDC YAML files

See related issues:

#3469985: Reconcile components module vs SDC namespaces for SDDS includes/embeds
#3465047: Remove unnecessary dependencies before DrupalCon Barcelona
#3454125: Implement temporary design system for the DrupalCon Barcelona demo
#3470024: Arrays in SDDS SDC YAMLs are causing fatal errors in XB

jacobadeutsch’s picture

Assigned: jacobadeutsch » kristen pol

Instructions were clear and I got XB running and everything. Not sure if the themes were working though, seemed like maybe they weren't.

kristen pol’s picture

@jacobadeutsch Let's talk through that then. They should show up in list and storybook should work.

kristen pol’s picture

Moving to postponed as the guide is okay for now but we'll need to see about changing it to D11 if we drop the components module dependency or if it gets a D11 release.

kristen pol’s picture

Assigned: kristen pol » Unassigned
Status: Needs review » Postponed

Whoops... change status.

kristen pol’s picture

Title: Update SDDS development guide to use standard Drupal 11 profile and XB » Update SDDS development guide to use standard Drupal 10 profile and XB
Issue summary: View changes
Status: Postponed » Fixed

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.