docs: changes as requested

Signed-off-by: Soumyadeep Ghosh <[email protected]>

Author: soumyaDghosh

docs/how-to/debugging/use-the-metadata-linter.rst

@@ -5,10 +5,9 @@ Use the metadata linter
 
 The following guidelines describe how to address issues flagged by the metadata linter.
 
-To resolve a missing metadata field, add the missing field to the snap's
-``snapcraft.yaml`` file.
+To resolve a missing metadata key, add it to the snap's project file.
 
-Currently these following metadata fields are linted:
+The following metadata keys are linted:
 
 - ``title``
 - ``contact``
@@ -20,4 +19,6 @@ Currently these following metadata fields are linted:
 
 See the :ref:`reference-snapcraft-yaml-top-level-keys` for more information about these keys.
 
-To ignore the metadata field, add the field to the ``lint.ignore.metadata`` key. See :ref:`how-to-disable-a-linter-ignore-specific-keys-of-metadata-linter` for more information.
+To ignore a key, add it to the ``lint.ignore.metadata`` key.
+
+See :ref:`how-to-disable-a-linter-ignore-specific-keys-of-metadata-linter` for more information.

docs/reference/linters.rst

@@ -23,4 +23,4 @@ Snapcraft runs the following linters:
   dependencies, such as libraries, are missing, and that no extra libraries are included
   in the snap package.
 - :ref:`Metadata <how-to-use-the-metadata-linter>`. Verifies that the snap contains all the
-  :ref:`metadata <reference-anatomy-of-snapcraft-yaml>` needed for a better listing in the snap store.
+  :ref:`metadata <reference-anatomy-of-snapcraft-yaml-metadata>` needed for a better listing in the snap store.

docs/reference/project-file/anatomy-of-snapcraft-yaml.rst

@@ -36,6 +36,8 @@ Several :ref:`top-level keys <reference-snapcraft-yaml-top-level-keys>` define a
 describe the snap.
 
 
+.. _reference-anatomy-of-snapcraft-yaml-metadata:
+
 Metadata
 ^^^^^^^^