Skip to content

docs: add Backdrop-specific config considerations.#7037

Merged
rfay merged 3 commits into
ddev:mainfrom
laryn:20250228_laryn_backdrop_docs_re_config_storage
Mar 7, 2025
Merged

docs: add Backdrop-specific config considerations.#7037
rfay merged 3 commits into
ddev:mainfrom
laryn:20250228_laryn_backdrop_docs_re_config_storage

Conversation

@laryn

@laryn laryn commented Feb 28, 2025

Copy link
Copy Markdown
Contributor

The Issue

Backdrop's config storage options can be confusing with local development, so it would be good to have a short description of the options as discussed in #7014 (comment)

As well, it is worth mentioning Backdrop's command line tool, bee.

Review rendered at https://ddev--7037.org.readthedocs.build/en/7037/users/usage/cms-settings/#backdrop-specifics

@laryn laryn requested a review from a team as a code owner February 28, 2025 20:55

@rfay rfay left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!


Backdrop also allows you to store your active configuration in the database ([as of Backdrop 1.28.0](https://docs.backdropcms.org/change-records/swappable-config-storage)), which can be simpler while developing locally, especially if you are making use of DDEV's snapshot feature. In this case, the database and the active configuration are effectively bundled and refreshing the database also refreshes the active configuration.

#### Command line tool

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder would it make sense to move the command line part over to the backdrop quickstart? i mean for drupal drush is contained in every quickstart available (except for drupal cms but that is shipping with drush out of the box) so i suppose wouldnt ddev add-on get backdrop-ops/ddev-backdrop-bee be better suited in the two backdrop quickstarts? or is bee used less extensively with backdrop compared to drush with drupal?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That makes sense to me.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It does seem like bee has become adequately standard now that it should just be installed from the add-on right away when setting up a project. That can be another PR of course.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've removed the CLI piece from this PR and will make another for the quickstarts.

@rfay

rfay commented Mar 2, 2025

Copy link
Copy Markdown
Member

There are minor markdown complaints in https://github.com/ddev/ddev/actions/runs/13596373138/job/38014122763?pr=7037, easy to fix with another commit.

@rfay rfay left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@rfay rfay merged commit beed40c into ddev:main Mar 7, 2025
@laryn laryn deleted the 20250228_laryn_backdrop_docs_re_config_storage branch March 7, 2025 03:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants