[INTERNAL] Enhance TODO / jsdoc comments

lib/graph/helpers/ui5Framework.js

@@ -209,14 +209,16 @@ const utils = {
 		}
 	},
 	/**
-	 * This logic needs to stay in sync with the @sapui5/distribution-metadata package
+	 * This logic needs to stay in sync with the dependency definitions for the
+	 * sapui5/distribution-metadata package.
 	 *
-	 * @param project
+	 * @param {@ui5/project/specifications/Project} project
 	 */
 	async getFrameworkLibraryDependencies(project) {
 		let dependencies = [];
 		let optionalDependencies = [];
 
+		// TODO: Add getter for ID
 		if (project.__id.startsWith("@sapui5/")) {
 			project.getFrameworkDependencies().forEach((dependency) => {
 				if (dependency.optional) {
@@ -241,7 +243,6 @@ const utils = {
 
 		return {dependencies, optionalDependencies};
 	},
-
 	async getWorkspaceFrameworkLibraryMetadata({workspace, projectGraph}) {
 		const libraryMetadata = Object.create(null);
 		const {projectNameMap} = await workspace._getResolvedModules(); // TODO: private API usage
@@ -294,7 +295,8 @@ export default {
 		let version = options.versionOverride || frameworkVersion;
 
 		if (rootProject.isFrameworkProject() && !version) {
-			// TODO: Also take workspace into account
+			// TODO: Also take workspace into account:
+			// Version should not be mandatory if all framework dependencies are part of the workspace
 
 			// If the root project is a framework project and no framework version is defined,
 			// all framework dependencies must already be part of the graph