Thank you for this but I think the documentation is already pointing to the right places at https://router.vuejs.org/guide/essentials/dynamic-matching.html#advanced-matching-patterns

This section of the documentation will be improved in v4 where the path to regex mechanism is internal

I understand what you're saying. Respectfully, I think you're missing out on an opportunity to help a lot of people with next to know effort or cost.

It seems extremely likely to me that optional URL parameters are an extremely common use-case among users of vue-router. However, currently the fact that they are possible is buried at the bottom of the page, and is only mentioned in passing as "optional dynamic segments"; to learn how to use them one has to click through to documentation on a dependency and find the examples there.

Introducing the possibility far earlier on the page, right after dynamic segments are introduced, feels much more contextually appropriate, and much more likely to be communicating the right information at the time that a developer might be wondering "can I make these segments optional?".

I really appreciate all of your work on this project, and of course it's your decision to close this. I just wanted to share my reasoning, in the hope that you'll reconsider 😄

Also, for what it's worth, as a new contributor it kind of stinks to come across what feels like some missing documentation, then find that there's an already open issue for it (#2525), and think to myself "oh great, I can help out and add this to the docs!", then make a PR and have it closed even though it clearly solves the existing open issue ¯_(ツ)_/¯