[mooreed]

Nice work. It always gives me heart burn when the docs say “basically the same” because now I have to do some digging to determine if the performance gains are worth my understanding if I am inside the “basically same” use case or in the “unfortunately slightly different or unsupported” use case.

Not to mention standard community/ ecosystem/ migration risk.

[mooreed]

I think it’s likely an easy switch for most people. But I would not over look the documentation of when does it not make sense. This usually engenders more confidence in the maintainers vision or perspective on how they achieve the performance gains. Since after all so much of the work you are doing comes down to making trade offs.

[newtang]

Author here, thanks for the feedback! Just to be clear, are you suggesting that I be more explicit in the documentation about the differences between the default router and Expresso? I have a "Migration" section, but it could be expanded and renamed.