Skip to content

Comments

docs: add command for ddevcd#8168

Closed
tyler36 wants to merge 2 commits intomainfrom
20260220-document-helper-for-ddevcd
Closed

docs: add command for ddevcd#8168
tyler36 wants to merge 2 commits intomainfrom
20260220-document-helper-for-ddevcd

Conversation

@tyler36
Copy link
Collaborator

@tyler36 tyler36 commented Feb 20, 2026

The Issue

I recently reset a WSL distro which required me to reinstall DDEV.
When I reached for ddevcd command I got an error:

$ ddevcd senju 
zsh: command not found: ddevcd
$ ddev -v      
ddev version v1.25.0

My Google skills found

  • the blog announce of the feature
  • with a link "tiny bit of one-time configuration" that displays the "Commands" page.
  • searching on this page for ddevcd lead to "Note that this command can’t work until you make a small addition to your .bashrc, .zshrc, or config.fish."

The required "small addition" didn't appear obvious to me though.

How This PR Solves The Issue

This PR adds a hint to type ddev debug cd, which the required commands for bach, zsh, and fish.

Manual Testing Instructions

Updated doc at https://ddev--8168.org.readthedocs.build/en/8168/users/usage/commands/#utility

Automated Testing Overview

Release/Deployment Notes

Clarified usage instructions for the 'utility cd' command by adding a note about using 'ddev debug cd' for setup.
@tyler36 tyler36 requested a review from a team as a code owner February 20, 2026 01:23
@tyler36 tyler36 changed the title docs: Clarified usage instructions for the 'utility cd' command by adding a note about using 'ddev debug cd' for setup. docs: add command for ddevcd Feb 20, 2026
Copy link
Member

@rfay rfay left a comment

Choose a reason for hiding this comment

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

I'm not sure the fix is right. You are actually in the ddev utility cd section. I think you're wanting to figure out how to use ddevcd ?

This is at https://ddev--8168.org.readthedocs.build/en/8168/users/usage/commands/#utility

image

Co-authored-by: Randy Fay <randy@randyfay.com>
@tyler36
Copy link
Collaborator Author

tyler36 commented Feb 20, 2026

I was looking at the origin PR here which has ddev debug cd and worked.

ddev utility cd looks more approriate here though.

@rfay
Copy link
Member

rfay commented Feb 20, 2026

The canonical name of the command changed because people complained about debug. But it's still in my fingers.

The problem here may be that we just don't have a good place to describe this, except maybe the ddev.com PR that you kindly put up.

@tyler36 tyler36 requested a review from rfay February 20, 2026 01:57
@rfay
Copy link
Member

rfay commented Feb 20, 2026

I'm sure we can figure out how to communicate this better, but I don't see how this helps. It already had exactly that text right below it. Is the problem that it was in a "code" section, so your eyes went right over it?

image

Please say again the problem you are trying to solve more generally. Is it that you lost ddevcd and couldn't figure out how to get it back? But that does come up right away in a search for "ddevcd" and takes you to https://ddev--8168.org.readthedocs.build/en/8168/users/usage/commands/#utility-cd

@tyler36
Copy link
Collaborator Author

tyler36 commented Feb 20, 2026

Wow. I'm sorry. My brain seems to be misfiring a lot today.

This PR doesn't seem approriate at all. I'm not sure why I was failing to comphrehend, it guess frustration and stress is catching up. 😞

@tyler36 tyler36 closed this Feb 20, 2026
@rfay
Copy link
Member

rfay commented Feb 20, 2026

We appreciate you all the time. I know there's a reason this didn't come through right, hopefully we'll figure out how to do better. But isn't ddevcd fantastic?

@stasadev stasadev deleted the 20260220-document-helper-for-ddevcd branch February 23, 2026 12:11
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.

2 participants