docs(context): change examples

Author: rkpattnaik780

docs/commands/rhoas.md

@@ -1,12 +1,16 @@
 package context
 
 import (
+	"path/filepath"
+
 	"github.com/redhat-developer/app-services-cli/pkg/cmd/context/create"
 	"github.com/redhat-developer/app-services-cli/pkg/cmd/context/delete"
 	"github.com/redhat-developer/app-services-cli/pkg/cmd/context/list"
 	"github.com/redhat-developer/app-services-cli/pkg/cmd/context/use"
 	kafkaUse "github.com/redhat-developer/app-services-cli/pkg/cmd/kafka/use"
 	registryUse "github.com/redhat-developer/app-services-cli/pkg/cmd/registry/use"
+	"github.com/redhat-developer/app-services-cli/pkg/core/localize"
+	"github.com/redhat-developer/app-services-cli/pkg/core/servicecontext"
 
 	"github.com/redhat-developer/app-services-cli/pkg/cmd/status"
 	"github.com/redhat-developer/app-services-cli/pkg/shared/factory"
@@ -15,10 +19,15 @@ import (
 
 // NewContextCmd creates a new command to manage service contexts
 func NewContextCmd(f *factory.Factory) *cobra.Command {
+
+	ctxDirLocation, _ := servicecontext.DefaultDir()
+
+	ctxLocation := filepath.Join(ctxDirLocation, "contexts.json")
+
 	cmd := &cobra.Command{
 		Use:     "context",
 		Short:   f.Localizer.MustLocalize("context.cmd.shortDescription"),
-		Long:    f.Localizer.MustLocalize("context.cmd.longDescription"),
+		Long:    f.Localizer.MustLocalize("context.cmd.longDescription", localize.NewEntry("ContextPath", ctxLocation)),
 		Example: f.Localizer.MustLocalize("context.cmd.example"),
 		Args:    cobra.NoArgs,
 	}

docs/commands/rhoas_context.md

@@ -9,6 +9,12 @@ rhoas context commands allow developers to:
   * Manage different service contexts by switching, listing and removing service contexts 
   * Share context with others to use the same set of services
   * Generating configuration for connecting to the services from various platforms and tools
+
+The loading order of contexts follows these rules:
+
+  1. If $RHOAS_CONTEXT environment variable is set, then contexts are managed using only that file
+  2. Otherwise, "UserConfigDir/rhoas/contexts.json" is used for contexts
+
 '''
 
 [context.cmd.example]
@@ -52,10 +58,13 @@ Print overview of the services in associated with a service context
 
 [context.status.cmd.example]
 one='''
-# View the status of all application services
+# View the status of all application services in the current service context
 $ rhoas context status
 
-# View the status of the Kafka instance set in the current context
+# View the status of all application services in a specific service context
+$ rhoas context status --name my-context
+
+# View the status of the Kafka instance set in the current service context
 $ rhoas context status kafka
 
 # View the status of your services in JSON format
@@ -65,19 +74,19 @@ $ rhoas context status -o json
 [context.kafkaUse.cmd.example]
 description = 'Examples of how to use the command'
 one = '''
-# Select a Kafka instance to be set in the current context
+# Select a Kafka instance by name to be set in the current context
 $ rhoas context kafka-use --name=my-kafka
 
-# Select a Kafka instance to be set in the current context
+# Select a Kafka instance by ID to be set in the current context
 $ rhoas context kafka-use --id=1iSY6RQ3JKI8Q0OTmjQFd3ocFRg
 '''
 
 [context.registryUse.cmd.example]
 one = '''
-# Use a Service Registry instance by name
+# Select a Service Registry instance by name to be set in the current context
 rhoas context service-registry-use --name my-service-registry
 
-# Use a Service Registry instance by ID
+# Select a Service Registry instance by ID to be set in the current context
 rhoas context service-registry-use --id 1iSY6RQ3JKI8Q0OTmjQFd3ocFRg
 '''
 

docs/commands/rhoas_context_kafka-use.md

@@ -780,10 +780,10 @@ You can select a  Kafka instance by name or ID.
 [kafka.use.cmd.example]
 description = 'Examples of how to use the command'
 one = '''
-# Select a Kafka instance to be the current instance
+# Select a Kafka instance by name to be set in the current context
 $ rhoas kafka use --name=my-kafka
 
-# Select a Kafka instance to be the current instance
+# Select a Kafka instance by ID to be set in the current context
 $ rhoas kafka use --id=1iSY6RQ3JKI8Q0OTmjQFd3ocFRg
 '''