docs: Add note about conflicting segments (#433) #2404

Job	Run time
Validate OpenAPI spec using Codegen	4m 0s
lint (14.x, 3.8)	1m 44s
push-to-en (14.x)	1m 34s
push-to-en-staging	0s
	7m 18s

Provide feedback