diff --git a/ts/interfaces/projectsettings.ts b/ts/interfaces/projectsettings.ts
index f5d4157..42a4e45 100644
--- a/ts/interfaces/projectsettings.ts
+++ b/ts/interfaces/projectsettings.ts
@@ -1,8 +1,19 @@
 export interface IHandlerSettings {
+  /**
+   * the slug is a globally unique slug that the package will be answer under
+   */
   slug: string;
+  /**
+   * the packagename points to the package to use in the supplied registry
+   */
   packageName: string;
+  /**
+   * environment variables are supplied to the service at runtime
+   */
   environmentVariables: { [key: string]: string };
-  registryId: string;
+  /**
+   * this is needed to know where to get the package to run
+   */
   registryDescriptor: {
     registryUrl: string;
     registryToken: string;