Skip to content
This repository has been archived by the owner on Feb 12, 2021. It is now read-only.

Separating etcd v3 library, tooling, language and usage from those of v2 #1089

Open
akauppi opened this issue May 31, 2017 · 0 comments
Open

Comments

@akauppi
Copy link

akauppi commented May 31, 2017

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/

screen shot 2017-05-31 at 13 29 36

@bgilbert 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 free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant