New API: Add a TODO comments

Signed-off-by: Martin Vrachev <[email protected]>

Author: MVrachev

tuf/api/metadata.py

@@ -561,6 +561,8 @@ def update(
         hashes: Optional[Mapping[str, Any]] = None,
     ) -> None:
         """Assigns passed info about snapshot metadata to meta dict. """
+        # TODO: Consider renaming this function:
+        # see: https://github.com/theupdateframework/tuf/issues/1230
         self.meta["snapshot.json"] = MetadataInfo(version, length, hashes)
 
 
@@ -619,6 +621,8 @@ def update(
         hashes: Optional[Mapping[str, Any]] = None,
     ) -> None:
         """Assigns passed (delegated) targets role info to meta dict. """
+        # TODO: Consider renaming this function:
+        # see: https://github.com/theupdateframework/tuf/issues/1230
         metadata_fn = f"{rolename}.json"
         self.meta[metadata_fn] = MetadataInfo(version, length, hashes)
 
@@ -769,6 +773,8 @@ def to_dict(self) -> Dict[str, Any]:
     # Modification.
     def update(self, filename: str, fileinfo: Mapping[str, Any]) -> None:
         """Assigns passed target file info to meta dict. """
+        # TODO: Consider renaming this function:
+        # see: https://github.com/theupdateframework/tuf/issues/1230
         self.targets[filename] = TargetInfo(
             fileinfo["length"], fileinfo["hashes"], fileinfo.get("custom")
         )