About device tree documents (mvsw61xx )

Talk about Documentation
1

I find the openwrt does not have documents about dts binding like linux kernel, so I advice developers to write a binding document for device tree.
for example, in my development process,
I find ea3500 has such code:

+
+	mvsw61xx {
+		compatible = "marvell,88e6171";
+		status = "okay";
+		reg = <0x10>;
+
+		mii-bus = <&mdio>;
+		cpu-port-0 = <5>;
+		cpu-port-1 = <6>;
+		is-indirect;
+	};
+

there is no any documents about such device tree binding!

+	dsa {
+		compatible = "marvell,dsa";
+		#address-cells = <2>;
+		#size-cells = <0>;
+
+		dsa,ethernet = <&eth0port>;
+		dsa,mii-bus = <&mdio>;
+
+		switch@16,0 {
+			#address-cells = <1>;
+			#size-cells = <0>;
+			reg = <16 0>;	/* MDIO address 16, switch 0 in tree */
+
+			port@0 {
+				reg = <0>;
+				label = "ethernet1";
+			};
+
+			port@1 {
+				reg = <1>;
+				label = "ethernet2";
+			};
+
+			port@2 {
+				reg = <2>;
+				label = "ethernet3";
+			};
+
+			port@3 {
+				reg = <3>;
+				label = "ethernet4";
+			};
+
+			port@4 {
+				reg = <4>;
+				label = "internet";
+			};
+
+			port@5 {
+				reg = <5>;
+				label = "cpu";
+			};
+		};
+	};
+};
+

and this part, in 4.14 or latter, the new format is taken, so this part is the demand of mvsw61xx binding?

thanks!!!

I find my kernel dsa working fine but kernel does not prompt mvsw61xx find switch at xxxx. why?first I did not enable kernel dsa driver, nether mvsw61xx nor 88e61xx in bootlog, second time I enable only 88e61xx with single cpu port.did not show mvsw61xx