draft

Author: aevesdocker

content/manuals/projects/_index.md

@@ -10,6 +10,10 @@ weight: 50
 description: Learn how to use Docker Projects which provides a unified, project-based workflow to run your containerized projects. 
 keywords: Docker, projects, docker deskotp, containerization
 grid:
+- title: How Docker Projects works
+  description: Learn How Docker Projects works
+  icon: category
+  link: /projects/about/
 - title: Open a new project
   description: Learn how to open a new local or remote projects.
   icon: checklist
@@ -22,6 +26,14 @@ grid:
   description: Run or remove your projects.
   icon: tune
   link: /projects/manage/
+- title: View your projects
+  description: View detailed information about your projects and services within your projects
+  icon: visibility
+  link: /projects/view/
+- title: FAQs
+  description: View common FAQs about Docker Projects
+  icon: help
+  link: /projects/faq/
 ---
 
 Docker Projects provides a simplified, project-based workflow for running and managing containerized applications. It organizes your code, configurations, and logs across local and cloud environments into a single view, making it easy to collaborate and share across teams.
@@ -35,37 +47,4 @@ A project organizes your code and Docker artifacts into a single object. These a
  - Custom `run` commands for your projects: Define and store preconfigured `run` commands that are equivalent to running `docker compose up`.
  - Local & remote projects:  Work on projects locally or sync artifacts to the cloud for cross-device access and easy collaboration.
 
-## How it works 
-
-Docker Projects requires a Compose file (docker-compose.yml) to define your application's services, networks, and configurations. When you open a project, Docker Projects automatically detects the Compose file, allowing you to configure and run services with pre-set commands. 
-
-By integrating with Docker Compose, Docker Projects ensures a consistent, easy-to-manage workflow for both individual developers and teams. Whether you're starting a new project, configuring it, or collaborating with a team, Docker Projects keeps the process simple.
-
-1. Create or open a project. You can:
-
- - Open a local project: Select a folder on your machine that contains your project code.
- - Clone a Git repository:Provide a repository URL and clone the project into a local directory.
-
-Once a project is opened, Docker Desktop detects the Compose file and prepares the project for execution.
-
-2. Configure and run your project with pre-configured commands. These commands:
-
- - Work like `docker compose up`, launching services based on the Compose file.
- - Can be customized with additional flags, multiple Compose files, and environment variables.
- - Allow pre-run tasks, such as executing scripts before starting the services.
-
-All of which means you can fine-tune your configurations without manually running complex CLI commands.
-
-3. Collaborate and share with teams. For projects linked to a Git repository, Docker Projects stores artifacts in the cloud, enabling easy collaboration:
-
- - Work across devices: Open a project from any machine and instantly access stored configurations.
- - Share configurations: Team members can access predefined run commands, reducing setup time.
-
-Collaboration is seamless—new developers can join a team, open a project, and start working without complex setup steps.
-
-4. Manage and iterate. Once a project is up and running, Docker Projects makes it easy to monitor, update, and troubleshoot:
-
- - View logs to debug issues and track service activity.
- - Edit configurations and run commands as requirements change.
-
 {{< grid >}}

content/manuals/projects/about.md

@@ -0,0 +1,36 @@
+---
+title: How it works
+description: Understand how Docker Projects works 
+keywords: docker projects
+---
+
+Docker Projects requires a Compose file (docker-compose.yml) to define your application's services, networks, and configurations. When you open a project, Docker Projects automatically detects the Compose file, allowing you to configure and run services with pre-set commands. 
+
+By integrating with Docker Compose, Docker Projects ensures a consistent, easy-to-manage workflow for both individual developers and teams. Whether you're starting a new project, configuring it, or collaborating with a team, Docker Projects keeps the process simple.
+
+1. Create or open a project. You can:
+
+ - Open a local project: Select a folder on your machine that contains your project code.
+ - Clone a Git repository:Provide a repository URL and clone the project into a local directory.
+
+Once a project is opened, Docker Desktop detects the Compose file and prepares the project for execution.
+
+2. Configure and run your project with pre-configured commands. These commands:
+
+ - Work like `docker compose up`, launching services based on the Compose file.
+ - Can be customized with additional flags, multiple Compose files, and environment variables.
+ - Allow pre-run tasks, such as executing scripts before starting the services.
+
+All of which means you can fine-tune your configurations without manually running complex CLI commands.
+
+3. Collaborate and share with teams. For projects linked to a Git repository, Docker Projects stores artifacts in the cloud, enabling easy collaboration:
+
+ - Work across devices: Open a project from any machine and instantly access stored configurations.
+ - Share configurations: Team members can access predefined run commands, reducing setup time.
+
+Collaboration is seamless—new developers can join a team, open a project, and start working without complex setup steps.
+
+4. Manage and iterate. Once a project is up and running, Docker Projects makes it easy to monitor, update, and troubleshoot:
+
+ - View logs to debug issues and track service activity.
+ - Edit configurations and run commands as requirements change.

content/manuals/projects/edit.md

@@ -2,7 +2,7 @@
 title: Add or edit your run commands
 description: Learn how to add or edit your run commands in Docker Projects
 keywords: Docker, projects, docker deskotp, containerization, open, remote, local, run commands
-weight: 20
+weight: 30
 ---
 
 ## Add a run command to a project

content/manuals/projects/faq.md

@@ -3,6 +3,7 @@ title: Docker Projects FAQs
 linkTitle: FAQs
 description: Find common FAQs for Docker Projects
 keywords: faqs, docker projects, local, remote
+weight: 60
 ---
 
 ## Why is a Compose file required?

content/manuals/projects/manage.md

@@ -2,7 +2,7 @@
 title: Manage your projects
 description: Learn how to delete or completely remove a project.
 keywords: Docker, projects, docker deskotp, containerization, open, remote, local
-weight: 30
+weight: 40
 ---
 
 ## Run a project or service

content/manuals/projects/open.md

@@ -91,7 +91,7 @@ To clone and open a remote project:
 
 2. Open your project by selecting your project under **Recents**, or by selecting the specific owner that your project is associated with and then select your project. 
 
-## Open an existing remote project
+### Open an existing remote project
 
 In the Projects page in Docker Desktop, existing remote projects display No local copy under the project. 
 

content/manuals/projects/share.md

@@ -3,6 +3,7 @@ title: Share and collaborate on a project
 linkTitle: Collaborate
 description: TBD
 keywords: TBD
+weight: 50
 ---
 
 Incoming..

content/manuals/projects/view.md

@@ -2,6 +2,7 @@
 title: View your project
 description: View information about your project or the services within your project.
 keywords: containers, docker projects, local, remote, docker desktop
+weight: 20
 ---