diff --git a/doc/index.md b/doc/index.md
index bc28cea1217f2415a49cee368bb96708ab111885..8d1b7a4cb80420c9b3198a3dc96c7ea2ce47af49 100644
--- a/doc/index.md
+++ b/doc/index.md
@@ -46,9 +46,9 @@ OpenSlice is used by Service Providers to design Network Services, expose them i
 There are various portals offering UI friendly access to users acting as Service Providers:
 
 * The Services portal allows Service Providers to design and expose services.
-* The Resoruce portal allows users to access resource specifications and running resources in resource inventory.
+* The Resource portal allows users to access resource specifications and running resources in resource inventory.
 * The NFV portal allows users to manage NFV artifacts and onboard them to a target MANO/NFV Orchestrator.
-* The teting portal allows Service Providers to manage test artifacts
+* The Testing portal allows Service Providers to manage test artifacts
 * The Products portal allows Service Providers to expose services as products
 
 ### OpenSlice for Service Consumers
@@ -57,9 +57,9 @@ OpenSlice allows Service Consumers to browse the available offered service speci
 There are various portals offering UI friendly access to users acting as Service Consumers:
 
 * The Services portal allows Service Consumers to select and order predefined services.
-* The Resoruce portal allows users to access running resources in resource inventory.
+* The Resource portal allows users to access running resources in resource inventory.
 * The NFV portal allows users to self-manage NFV artifacts and onboard them to a target MANO/NFV Orchestrator.
-* The testing portal allows Service Consumers to manage test artifacts
+* The Testing portal allows Service Consumers to manage test artifacts
 * The Products portal allows Service Consumers to expose services as products
 
 3rd party applications can use OpenSlice through TMForum Open APIs.
diff --git a/doc/naas/introduction.md b/doc/naas/introduction.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..12d4a9396a2c591a126f7748957a330e67ad520b 100644
--- a/doc/naas/introduction.md
+++ b/doc/naas/introduction.md
@@ -0,0 +1,18 @@
+# Network as a Service (NaaS)
+
+This section describes some core concepts for Delivering Network as a Service in OpenSlice. There are many articles and reports on the subject like 
+* TMF909 API Suite Specification for NaaS
+* TMF926A Connectivity_as_a_Service 
+* TMF931-Open_Gateway_Onboarding_and_Ordering_Component_Suite
+* GSMA Open Gatewy initiative
+
+In general Network as a Service (NaaS) is a  service model that allows users to consume network infrastructure and services , similar to how they would consume other cloud services like Software as a Service (SaaS) or Infrastructure as a Service (IaaS). NaaS abstracts the complexity of managing physical network infrastructure, providing users with virtualized network resources that can be dynamically allocated and managed through software.
+
+
+# OpenSlice and NaaS
+
+OpenSlice makes extensive use of TMFORUM's models and APIs. Therefore if one is familiar with TMF APIs the terminology and ideas are the same.
+
+To deliver NaaS we need to incorporate various APIs (see TMF909 API Suite Specification for NaaS). OpenSlice implements various TMF APIs to deliver NaaS and support the  lifecycle functions required to manage the network capabilities exposed as Network as a Service and managed by operational domains.
+
+For a complete list of supported APIs, see [Supported APIs](exposed_apis.md)
\ No newline at end of file
diff --git a/doc/naas/resource_catalog.md b/doc/naas/resource_catalog.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..c7ac604d058a19efd723e8b71357f19ab99dda09 100644
--- a/doc/naas/resource_catalog.md
+++ b/doc/naas/resource_catalog.md
@@ -0,0 +1,6 @@
+
+
+#OpenSlice Resource Catalog:
+
+    * Resource Specifications: Defines the underlying resources required to deliver services, such as network components, servers, and software.
+    * Resource Availability: Tracks the availability and status of resources to ensure efficient service delivery.
\ No newline at end of file
diff --git a/doc/naas/service_catalog.md b/doc/naas/service_catalog.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..01663a9e39a555dbf52ee33028bd0f8e7fd04512 100644
--- a/doc/naas/service_catalog.md
+++ b/doc/naas/service_catalog.md
@@ -0,0 +1,22 @@
+# OpenSlice Service Catalogs
+
+OpenSlice offers complete management of  Service Catalogs which offer to end users:
+* Service categories: Lists the available services, including their specifications and performance metrics.
+* Service Bundles: Combines multiple services into a single offering to provide added value to customers.
+
+
+Service Catalogs contain Service Specifications exposed to users for Service Orders.
+
+In the UI this looks like this
+
+
+
+## Example Use Case
+
+Scenario: A service provider wants to offer a new managed XXXX service to enterprise customers.
+
+  * Service Definition:  Service Template thus create a template for the XXXX service, including specifications for bandwidth, network features, and performance metrics.
+  * Service Catalog Integration: Add to Service Catalog the XXXX service  with all relevant details.
+  * Service Delivery/Order: Provision Service by Using the orchestration system to provision and configure the XXXX service based on customer orders.
+
+
diff --git a/doc/service_design/intro.md b/doc/service_design/intro.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..bae9fc8b0f9ca89100e2ae63185cc0bbee4dfb0b 100644
--- a/doc/service_design/intro.md
+++ b/doc/service_design/intro.md
@@ -0,0 +1,18 @@
+# Service Design in OpenSlice
+
+This section offers details on how to design Service Specifications and expose them in Service Catalogs
+
+## Intended Audience: Service Designers
+
+Service Designers create detailed service specifications, which are then managed and exposed in service catalogs. These services are integrated into OpenSlice E2E service orchestration framework to automate and optimize the delivery of network services.
+
+
+OpenSlice can be used to design service specifications for various services, even not networking related services. Here we cover how service designers can expose services related to the NFV world and the containerized world.
+
+## What's next
+
+* [Design and expose services based on containerized resources via the Kubernetes Operator pattern](ExposingKubernetesResources.md)
+* [Design and expose services based on NFV artifacts](./nfv/design_nfv_services.md)
+
+
+
diff --git a/doc/service_design/kubernetes/helm/design_helmaas.md b/doc/service_design/kubernetes/helm/design_helmaas.md
index a4722cdd97fa48955ccd31650d1f16390e768bae..411910eacb6a72b489a9cad5a0a9e7e40248a9de 100644
--- a/doc/service_design/kubernetes/helm/design_helmaas.md
+++ b/doc/service_design/kubernetes/helm/design_helmaas.md
@@ -64,4 +64,4 @@ see image:
 ## What's next
 
 
-See the [Example: Offer Jenkins as a Service via Openslice](helm/HELM_Installation_aaS_Jenkins_Example.md) 
+See the [Example: Offer Jenkins as a Service via Openslice](HELM_Installation_aaS_Jenkins_Example.md) 
diff --git a/doc/service_design/nfv/design_nfv_services.md b/doc/service_design/nfv/design_nfv_services.md
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/doc/terminology.md b/doc/terminology.md
index 5e1e9de1ca90d87023907dabc4650f4ec00a056f..204adb87c47fc391e6406b5a20ac6408928ee7f1 100644
--- a/doc/terminology.md
+++ b/doc/terminology.md
@@ -1,3 +1,13 @@
-OpenSlice management cluster
+# User Roles
+User
+Service Designer
 OpenSlice administrator
-Service Designer
\ No newline at end of file
+
+
+# Terms
+
+OpenSlice management cluster
+Service Specification: Detailed descriptions of services, including attributes, configurations, performance metrics, and SLAs.
+Service Catalog
+Service Inventory
+
diff --git a/mkdocs.yml b/mkdocs.yml
index 127d9047ef2e34d94d9fe75cc1785794ee535115..aba5dfbf8cc2d56b40ddcd50e1fa9d52e068e44b 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -88,13 +88,13 @@ nav:
   - NaaS:
     - Introduction: ./naas/introduction.md
     - Services:
-      - Service Specification: ./naas/service_spec.md
       - Service Catalogs: ./naas/service_catalog.md
+      - Service Specification: ./naas/service_spec.md
       - Service Inventory: ./naas/service_inventory.md
       - GSMA GST to TMF Service: ./naas/gst_to_tmf.md      
     - Resources:
-      - Resources Specification: ./naas/resource_spec.md
       - Resources Catalogs:  ./naas/resource_catalog.md
+      - Resources Specification: ./naas/resource_spec.md
       - Resources Inventory:  ./naas/resource_inventory.md
     - Service orchestration:
       - Introduction: ./naas/so_intro.md
@@ -123,7 +123,7 @@ nav:
       - Open5GS (NFV approach): ./service_design/examples/open5gs_nfv.md
       - Open5GS (Kubernetes approach): ./service_design/examples/open5gs_kubernetes.md
       - Exposing CRDs_aaS_Example_Calculator: ./service_design/examples/ExposingCRDs_aaS_Example_Calculator/ExposingCRDs_aaS_Example_Calculator.md
-      - HELM Installation aaS Jenkins Example: ./service_design//kubernetes/helm/HELM_Installation_aaS_Jenkins_Example.md
+      - HELM Installation aaS Jenkins Example: ./service_design/kubernetes/helm/HELM_Installation_aaS_Jenkins_Example.md
   - Service Ordering:
     - Ordering Services from catalogs: ./service_ordering/ordering_services.md
   - Testing services: