Skip to content

Conversation

@atj4me
Copy link
Contributor

@atj4me atj4me commented Oct 20, 2025

The Issue

The Tailscale DDEV add-on blog post was outdated and no longer accurately reflected the current v3.0.0 architecture, commands, and features. The post contained:

  • Incorrect architecture description (separate container vs userspace networking)
  • Outdated command structure and workflow
  • Missing new authentication options
  • No uninstall instructions
  • No mention of the significant v3.0.0 updates

How This PR Solves The Issue

This PR comprehensively updates the blog post to reflect all v3.0.0 changes:

  • Architecture: Updated description to reflect userspace networking approach with better macOS compatibility
  • Authentication: Added alternative interactive authentication method using ddev tailscale login
  • Commands: Updated to new simplified command structure (ddev tailscale share, ddev tailscale stop, etc.)
  • Workflow: Added requirement to explicitly start sharing (no longer auto-connects)
  • Documentation: Added uninstall instructions and mention of ddev tailscale help command
  • Version awareness: Added prominent update notice linking to v3.0.0 migration instructions
  • Clarity: Clarified differences with ddev share (ngrok requirement)
  • Metadata: Updated modified date and summary to indicate v3.0.0 compatibility

Manual Testing Instructions

  1. Review the updated blog post content for accuracy
  2. Verify all links are working and point to correct documentation
  3. Check that code examples use the correct v3.0.0 command syntax
  4. Ensure the migration notice is prominently displayed
  5. Validate that the uninstall instructions are clear and complete

Automated Testing Overview

This PR updates documentation content only. The existing site build and content validation tests will verify:

  • Markdown syntax and frontmatter validation
  • Link checking for external resources
  • Content structure and schema compliance

Related Issue Link(s)

N/A - This is a documentation update to keep the blog post current with the latest add-on version.

Release/Deployment Notes

No deployment actions required. This is a content update that will be automatically deployed with the next site build. The updated post will help users understand the latest v3.0.0 features and migration path from earlier versions.


Files Changed:

  • src/content/blog/tailscale-router-ddev-addon.md

Key Changes:

  • Updated architecture description from separate container to userspace networking
  • Added new authentication flow with ddev tailscale login
  • Updated all command examples to v3.0.0 syntax
  • Added explicit sharing workflow requirement
  • Added uninstall instructions section
  • Added ddev tailscale help command mention
  • Added v3.0.0 update notice with migration link
  • Clarified ngrok requirement differences
  • Updated frontmatter metadata (modifiedDate, summary)
  • Updated attribution section

@github-actions
Copy link

github-actions bot commented Oct 20, 2025

🌐 Fork Preview for PR #451

https://pr-451.ddev-com-fork-previews.pages.dev

This preview updates automatically when you push changes to your fork.

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.

Thanks for maintaining this!

Copy link
Member

@stasadev stasadev left a comment

Choose a reason for hiding this comment

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

Thank you, looks good to me.

I have a small suggestion.

@rfay
Copy link
Member

rfay commented Oct 20, 2025

Say when you're ready and I'll pull it.

@atj4me
Copy link
Contributor Author

atj4me commented Oct 20, 2025

@rfay I applied the suggestion by @stasadev ! I didn't knew that existed.

@rfay
Copy link
Member

rfay commented Oct 20, 2025

Not sure I did either! I'll try to remember it!

@rfay rfay merged commit 382d303 into ddev:main Oct 20, 2025
4 checks passed
@github-actions
Copy link

PR closed. The Cloudflare Pages preview is no longer updated.

@atj4me atj4me deleted the update-documentation-tailscale-ddev-router branch October 20, 2025 19:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants