[DOC] documentation latest contains old v1 api (as opposed to stable that has v2 already) (EPROT-38)

[cederom]

Checklist

• Checked the issue tracker for similar issues to ensure this is not a duplicate
• Read the documentation to confirm the issue is not addressed there and your configuration is set correctly
• Tested with the latest version to ensure the issue hasn't been fixed

How often does this bug occurs?

always

Expected behavior

Hello world :-)

While going back to esp-modbus documentation, latest version, it seems to point to the old v1 API, while current API is v2 as pointed by stable version of documentation.

Looks like "latest" doc reference should be updated?

Actual behavior (suspected bug)

https://docs.espressif.com/projects/esp-modbus/en/latest/ points to v1 API while latest is v2 API as pointed correctly by https://docs.espressif.com/projects/esp-modbus/en/stable/

Error logs or terminal output

Steps to reproduce the behavior

1. Go to https://docs.espressif.com/projects/esp-modbus/en/stable/ see it shows v2 API.
2. Go to https://docs.espressif.com/projects/esp-modbus/en/latest see it shows v1 API.

Project release version

v2.1.1

System architecture

Intel/AMD 64-bit (modern PC, older Mac)

Operating system

Linux

Operating system version

FreeBSD 14.3

Shell

ZSH

Additional context

No response

[Godoy-Octavio]

Hello, @cederom

Thank you for reporting. This issue was confirmed and will follow the process to be fixed.

[alisitsyn]

Hello @cederom ,

Please note that the latest link still includes the note with the links to the discussion page and also to the documentation links for both versions of the stack. This was made intentionally this way because some users still use the legacy v1 version and are trying to get documentation from the latest link provided in the documentation for old versions of esp-idf (in old versions of idf the esp-modbus was part of the idf). The latest link still needs to address both versions of the stack.

[cederom]

I would advise using explicit version numbers, for instance like in ESP-IDF and all other projects - there is a drop down menu with version to select so all is clear, latest usually points to master branch, stable usually points to latest release (or this could be replaced with specific versions) - screenshot below, thanks for considering :-)

[alisitsyn]

@cederom,

Thanks for the feedback. This was originally supported in esp-modbus but later changed to limit the space on the server. This is better to return this approach with v2 added. I accept this to find better way to make the esp-modbus project versioning clear with minor priority.