[avro] branch master updated: AVRO-3436: Clarify what names have a namespace (#1587)

[rs...@apache.org]

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

rskraba pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/avro.git


The following commit(s) were added to refs/heads/master by this push:
     new e4a40c4d6 AVRO-3436: Clarify what names have a namespace (#1587)
e4a40c4d6 is described below

commit e4a40c4d6e93a50c17f7e42dd54928f8c42f633d
Author: Oscar Westra van Holthe - Kind <op...@users.noreply.github.com>
AuthorDate: Tue Jun 21 19:59:23 2022 +0200

    AVRO-3436: Clarify what names have a namespace (#1587)
---
 doc/content/en/docs/next/Specification/_index.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/content/en/docs/next/Specification/_index.md b/doc/content/en/docs/next/Specification/_index.md
index cead16a28..cde92fed9 100755
--- a/doc/content/en/docs/next/Specification/_index.md
+++ b/doc/content/en/docs/next/Specification/_index.md
@@ -179,9 +179,11 @@ For example, 16-byte quantity may be declared with:
 ```
 
 ### Names {#names}
-Record, enums and fixed are named types. Each has a fullname that is composed of two parts; a name and a namespace. Equality of names is defined on the fullname.
+Record, enums and fixed are named types. Each has a fullname that is composed of two parts; a name and a namespace, separated by a dot. Equality of names is defined on the fullname.
 
-The name portion of a fullname, record field names, and enum symbols must:
+Record fields and enum symbols have names as well (but no namespace). Equality of fields and enum symbols is defined on the name of the field/symbol within its scope (the record/enum that defines it). Fields and enum symbols across scopes are never equal.
+
+The name portion of the fullname of named types, record field names, and enum symbols must:
 
 * start with [A-Za-z_]
 * subsequently contain only [A-Za-z0-9_]