You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository has been archived by the owner on Feb 12, 2021. It is now read-only.
It seems to me that a cleanup of the "v3" page would be in place. It contains entries that seem rather stale, and could be removed. It could clearly indicate which projects aim at supporting the v3 API, since this starts to be a practical use case for coming to the documentation (at least for me). It could show coreos/jetcd as more "under construction", since it doesn't provide watch support, test coverage is said to be partial, and (because of these) it's not pushed to Maven Central.
In short, v3 could probably do with a dramatically shorter listing of libraries, tools and languages, than the v2 list.
Ideally, I could reason that the page is simply in the wrong place. Since both v2 and v3 support the v2 API, it should live somewhere outside of the "Communicating with etcd v[23]" roof (if both pages are still maintained).
If v2 page is "frozen", the solution could be to have separate "Libraries, tools and languages (v3 API)", and "... (v2 API)" pages.
In addition, the "Projects using etcd" seems to be in completely wrong place. It belongs in a git repo README, or something similar? (it's not essential for "communicating with etcd").
One more thing... v2 page sidebar has "langauge bindings" (misspelling). I don't find it in this repo - no idea where it's coming from. https://coreos.com/etcd/docs/latest/
The text was updated successfully, but these errors were encountered:
bgilbert
changed the title
Separating v3 library, tooling, language and usage from those of v2
Separating etcd v3 library, tooling, language and usage from those of v2
Aug 19, 2017
Sign up for freeto subscribe to this conversation on GitHub.
Already have an account?
Sign in.
The current situation between v2 and v3 in the documentation is confusing. There are separate "libraries, tools and languages" pages, for v3 and v2:
It seems to me that a cleanup of the "v3" page would be in place. It contains entries that seem rather stale, and could be removed. It could clearly indicate which projects aim at supporting the v3 API, since this starts to be a practical use case for coming to the documentation (at least for me). It could show
coreos/jetcd
as more "under construction", since it doesn't provide watch support, test coverage is said to be partial, and (because of these) it's not pushed to Maven Central.In short, v3 could probably do with a dramatically shorter listing of libraries, tools and languages, than the v2 list.
Ideally, I could reason that the page is simply in the wrong place. Since both v2 and v3 support the v2 API, it should live somewhere outside of the "Communicating with etcd v[23]" roof (if both pages are still maintained).
If v2 page is "frozen", the solution could be to have separate "Libraries, tools and languages (v3 API)", and "... (v2 API)" pages.
In addition, the "Projects using etcd" seems to be in completely wrong place. It belongs in a git repo README, or something similar? (it's not essential for "communicating with etcd").
One more thing... v2 page sidebar has "langauge bindings" (misspelling). I don't find it in this repo - no idea where it's coming from. https://coreos.com/etcd/docs/latest/
The text was updated successfully, but these errors were encountered: