Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Nov 14, 2025

docs: add target property for links in navigation

Summary

Documents the new target property for links in the docs navigation system. This property allows users to specify where links open (new tab, same tab, etc.) and applies to:

  • Product links (external products)
  • Tab links (external tabs)
  • Page links (navigation links)
  • Navbar links

Added concise documentation in five locations:

  1. Navigation overview page - added "Link target" subsection under "Links"
  2. Tabs page - added inline comment to external tab example
  3. Products page - added inline comment to external product example
  4. Site-level settings page - added target ParamField for navbar-links configuration
  5. Changelog entry for 2025-11-14

Also fixed a Vale style warning by removing the time-relative term "now" from the changelog.

Review & Testing Checklist for Human

  • Verify feature completeness: Test that the target property actually works for all four link types (product, tab, page, navbar) in a real docs.yml configuration. I documented this based on the Slack announcement but haven't tested it myself.
  • Check for missing locations: Confirm there aren't other places where target should be documented. Specifically, check if dropdown menu items within navbar-links support target, or if there are other link types I missed.
  • Validate property values: Verify that _blank, _self, _parent, and _top are the complete and correct set of valid values. These are standard HTML target values, but the implementation might support a different subset.
  • Test examples: Try the code examples in the documentation to ensure they work as expected and produce the desired behavior.
  • Confirm changelog date: Verify that 2025-11-14 is the appropriate date for this changelog entry, or if it should match the actual feature release date.

Notes

@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@@ -0,0 +1,11 @@
## Link target property

You can now specify where links open using the `target` property. This applies to product links, tab links, page links, and navbar links. Options are `_blank` (new tab), `_self` (same tab, default), `_parent`, and `_top`.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ [vale] reported by reviewdog 🐶
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated

@github-actions
Copy link
Contributor

@github-actions
Copy link
Contributor

@github-actions
Copy link
Contributor

@github-actions
Copy link
Contributor

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.

2 participants