diff --git a/docs/data-sources/filesystem.md b/docs/data-sources/filesystem.md
index a527cd2..e3a4d32 100644
--- a/docs/data-sources/filesystem.md
+++ b/docs/data-sources/filesystem.md
@@ -19,12 +19,12 @@ linkTitle: "powerscale_filesystem"
 page_title: "powerscale_filesystem Data Source - terraform-provider-powerscale"
 subcategory: ""
 description: |-
-  FileSystem data source.This is used to query the existing FileSystem(Namespace Directory) from PowerScale array.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.
+  This datasource is used to query the existing FileSystem(Namespace Directory) from PowerScale array. The information fetched from this datasource can be used for getting the details / for further processing in resource block.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.
 ---
 
 # powerscale_filesystem (Data Source)
 
-FileSystem data source.This is used to query the existing FileSystem(Namespace Directory) from PowerScale array.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.
+This datasource is used to query the existing FileSystem(Namespace Directory) from PowerScale array. The information fetched from this datasource can be used for getting the details / for further processing in resource block.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.
 
 ## Example Usage
 
diff --git a/docs/resources/filesystem.md b/docs/resources/filesystem.md
index 25090f7..61536b3 100644
--- a/docs/resources/filesystem.md
+++ b/docs/resources/filesystem.md
@@ -19,12 +19,12 @@ linkTitle: "powerscale_filesystem"
 page_title: "powerscale_filesystem Resource - terraform-provider-powerscale"
 subcategory: ""
 description: |-
-  FileSystem resource.This Resource allows you to manage the Namespace Directory on the Powerscale array
+  This resource is used to manage the FileSystem(Namespace directory) entity of PowerScale Array. We can Create, Update and Delete the FileSystem using this resource. We can also import an existing FileSystem from PowerScale array.
 ---
 
 # powerscale_filesystem (Resource)
 
-FileSystem resource.This Resource allows you to manage the Namespace Directory on the Powerscale array
+This resource is used to manage the FileSystem(Namespace directory) entity of PowerScale Array. We can Create, Update and Delete the FileSystem using this resource. We can also import an existing FileSystem from PowerScale array.
 
 
 ## Example Usage
diff --git a/powerscale/provider/file_system_datasource.go b/powerscale/provider/file_system_datasource.go
index 24a0b26..f2ebb45 100644
--- a/powerscale/provider/file_system_datasource.go
+++ b/powerscale/provider/file_system_datasource.go
@@ -53,8 +53,8 @@ func (d *FileSystemDataSource) Metadata(ctx context.Context, req datasource.Meta
 func (d *FileSystemDataSource) Schema(ctx context.Context, req datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
 		// This description is used by the documentation generator and the language server.
-		MarkdownDescription: "FileSystem data source.This is used to query the existing FileSystem(Namespace Directory) from PowerScale array.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.",
-		Description:         "FileSystem data source.This is used to query the existing FileSystem(Namespace Directory) from PowerScale array.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.",
+		MarkdownDescription: "This datasource is used to query the existing FileSystem(Namespace Directory) from PowerScale array. The information fetched from this datasource can be used for getting the details / for further processing in resource block.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.",
+		Description:         "This datasource is used to query the existing FileSystem(Namespace Directory) from PowerScale array. The information fetched from this datasource can be used for getting the details / for further processing in resource block.It allows you to get information which includes all metadata , access control , quotas and snapshots related information for the directory.",
 
 		Attributes: map[string]schema.Attribute{
 			"id": schema.StringAttribute{
diff --git a/powerscale/provider/file_system_resource.go b/powerscale/provider/file_system_resource.go
index 1e81c16..0405bed 100644
--- a/powerscale/provider/file_system_resource.go
+++ b/powerscale/provider/file_system_resource.go
@@ -61,7 +61,8 @@ func (r *FileSystemResource) Metadata(ctx context.Context, req resource.Metadata
 func (r *FileSystemResource) Schema(ctx context.Context, req resource.SchemaRequest, resp *resource.SchemaResponse) {
 	resp.Schema = schema.Schema{
 		// This description is used by the documentation generator and the language server.
-		MarkdownDescription: "FileSystem resource.This Resource allows you to manage the Namespace Directory on the Powerscale array",
+		MarkdownDescription: "This resource is used to manage the FileSystem(Namespace directory) entity of PowerScale Array. We can Create, Update and Delete the FileSystem using this resource. We can also import an existing FileSystem from PowerScale array.",
+		Description:         "This resource is used to manage the FileSystem(Namespace directory) entity of PowerScale Array. We can Create, Update and Delete the FileSystem using this resource. We can also import an existing FileSystem from PowerScale array.",
 
 		Attributes: map[string]schema.Attribute{
 			"id": schema.StringAttribute{