[skywalking] 01/01: Add agent compatibility doc for the first time.

[wu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wusheng pushed a commit to branch agent-compatibility-doc
in repository https://gitbox.apache.org/repos/asf/skywalking.git

commit a315c74679b02ac27b90a5fd77de2f0d535498fd
Author: Wu Sheng <wu...@foxmail.com>
AuthorDate: Tue Sep 14 11:59:56 2021 +0800

    Add agent compatibility doc for the first time.
---
 docs/en/setup/service-agent/agent-compatibility.md | 27 ++++++++++++++++++++++
 docs/menu.yml                                      |  2 ++
 2 files changed, 29 insertions(+)

diff --git a/docs/en/setup/service-agent/agent-compatibility.md b/docs/en/setup/service-agent/agent-compatibility.md
new file mode 100644
index 0000000..89284d6
--- /dev/null
+++ b/docs/en/setup/service-agent/agent-compatibility.md
@@ -0,0 +1,27 @@
+# Compatibility
+
+SkyWalking 8.0+ uses v3 protocols. Agents don't have to keep the same versions as the OAP backend.
+
+## SkyWalking Native Agents
+
+|OAP Server Version|Java|Python|NodeJS|LUA|Kong|Browser Agent|
+----------- | ---------- | --------- | --------- |--------- |--------- |--------- |
+8.0.1 - 8.1.0 | 8.0.0 - 8.3.0 | < = 0.6.0| < = 0.3.0 | All | All | No |
+8.2.0 - 8.3.0 | 8.0.0 - 8.3.0 | < = 0.6.0| < = 0.3.0 | All | All | All |
+8.4.0+ | \> = 8.0.0 | All | All | All | All | All |
+
+## Ecosystem Agents
+
+All following agent implementations are a part of SkyWalking ecosystem. All the source codes and their distributions
+don't belong to the Apache Software Foundation.
+
+|OAP Server Version|DotNet|Go2sky|cpp2sky|PHP agent|
+----------- | ---------- | --------- | --------- |--------- |
+8.0.1 - 8.3.0 | 1.0.0 - 1.3.0 | 0.4.0 - 0.6.0 | < = 0.2.0 | \> = 3.0.0|
+8.4.0+ | \> = 1.0.0 | \> = 0.4.0  | All | \> = 3.0.0|
+
+All these projects are maintained by their own communities, please reach them if you face any compatibility issue.
+
+___
+All above compatibility are only references, if you face `unimplemented` error, it means you need to upgrade OAP backend
+to support newer features in the agents.
\ No newline at end of file
diff --git a/docs/menu.yml b/docs/menu.yml
index f01edcf..193e60b 100644
--- a/docs/menu.yml
+++ b/docs/menu.yml
@@ -61,6 +61,8 @@ catalog:
         path: "/en/setup/service-agent/server-agents"
       - name: "Browser Agent"
         path: "/en/setup/service-agent/browser-agent"
+      - name: "Compatibility"
+        path: "/en/setup/service-agent/agent-compatibility"
       - name: "Backend"
         catalog:
           - name: "Quick Start"