reword pages for clarity

Author: commit111

docs/concepts/portal.md

@@ -8,14 +8,13 @@ sidebar_position: 700
 
 You can log into the Defang Portal at [portal.defang.dev](https://portal.defang.dev) using your [Defang account](./accounts.md) to view the state of your Defang services running in the Defang Playground for non-production applications.
 
-You can use the Portal to get an overview of your services, view the logs for each service, quickly access exposed ports, view environment variables, and more.
-
+You can use the Portal to get an overview of your [services](/docs/concepts/services), view the logs for each service, quickly access exposed ports, view environment variables, and more.
 
 :::info
-The Defang Portal displays services deployed to Playground. 
+The Defang Portal displays services deployed to Defang Playground. 
 To view services deployed to Defang BYOC, please check out [Monitoring Your Services](/docs/tutorials/monitoring-your-services).
 :::
 
 :::tip
-We have a tool in place to help [debug](/docs/concepts/debug) your application in production. 
-:::
+Need help with a failing deployment? Defang provides a tool to help [debug](/docs/concepts/debug) in your application.
+:::

docs/concepts/services.md

@@ -10,14 +10,14 @@ Defang allows you deploy services defined as containers. You can define your ser
 
 `<username>-<service-name>`
 
-You can learn more about accounts and usernames in the [accounts page](./accounts.md).
+You can learn more about accounts and usernames in the [Accounts page](./accounts.md).
 
-:::tip Service Names
+:::tip
 Service names are defined in your Compose file or your Pulumi program.
 :::
 
-You can learn more about about how to define [services with Compose files here](./compose.md) and [services with Pulumi here](./pulumi.md). You can learn more about how services are deployed in the [deployment page](./deployments.md).
+Defang manages the deployment process for services. You can learn more about how services are deployed in the [Deployment page](./deployments.md).
 
 :::info
-While this is the current state of the Defang model, we plan to add support for other types of services in the future, including serverless functions.
+We plan to add support for other types of services in the future, including serverless functions.
 :::