[incubator-opendal] branch main updated: doc: update vision to be more clear (#2164)

[xu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

xuanwo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-opendal.git


The following commit(s) were added to refs/heads/main by this push:
     new a3935f14 doc: update vision to be more clear (#2164)
a3935f14 is described below

commit a3935f14f6736eb27910f6595c3210d4b45c6f91
Author: xxchan <xx...@gmail.com>
AuthorDate: Sat Apr 29 12:02:54 2023 +0200

    doc: update vision to be more clear (#2164)
    
    * doc: update vision to be more clear
    
    * caplitalize
---
 website/docs/vision.md | 38 +++++++++++++++++++++-----------------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/website/docs/vision.md b/website/docs/vision.md
index 17704015..28666bb3 100644
--- a/website/docs/vision.md
+++ b/website/docs/vision.md
@@ -15,13 +15,14 @@ OpenDAL must enable users to access various storage services ranging from `s3` t
 
 ### Examples
 
-- Add support for [Google Drive](https://www.google.com/drive/): Good, it allows users to access and manage their data on the [Google Drive](https://www.google.com/drive/).
-- Add support for [Object Storage Service (OSS)](https://www.alibabacloud.com/product/object-storage-service) via native API: Good, users can utilize Aliyun's RAM support.
-- Add support for [supabase storage](https://supabase.com/docs/guides/storage): Good, users can visit `supabase storage` now!
+We
+- Add support for [Google Drive](https://www.google.com/drive/): It allows users to access and manage their data on the [Google Drive](https://www.google.com/drive/).
+- Add support for [Object Storage Service (OSS)](https://www.alibabacloud.com/product/object-storage-service) via native API: Users can utilize Aliyun's RAM support.
+- Add support for [supabase storage](https://supabase.com/docs/guides/storage): Users can visit `supabase storage` now!
 
-
-- Add support for [Google Cloud Storage(GCS)](https://cloud.google.com/storage) via [XML API](https://cloud.google.com/storage/docs/xml-api/overview): Bad, [GCS](https://cloud.google.com/storage) has native [JSON API](https://cloud.google.com/storage/docs/json_api) which more powerful
-- Add support for `MySQL/PostgreSQL`: Bad, relational DBMS provides data types such as BLOB, but they are often not used as a storage service.
+We don't
+- Add support for [Google Cloud Storage(GCS)](https://cloud.google.com/storage) via [XML API](https://cloud.google.com/storage/docs/xml-api/overview): [GCS](https://cloud.google.com/storage) has native [JSON API](https://cloud.google.com/storage/docs/json_api) which more powerful
+- Add support for `MySQL/PostgreSQL`: Relational DBMS provides data types such as BLOB, but they are often not used as a storage service.
 
 ## 2. Free from implementations
 
@@ -29,12 +30,13 @@ OpenDAL needs to separate the various implementation details of services and ena
 
 ### Examples
 
-- Add a new capability to indicate whether `presign` is supported: Good, users can now write logic based on the `can_presign` option.
-- Add a `default_storage_class` configuration for the S3 service: Good, configuration is specific to the S3 service.
-- Add an option for `content_type` in the `write` operation: Good, it aligns with HTTP standards.
-
+We
+- Add a new capability to indicate whether `presign` is supported: Users can now write logic based on the `can_presign` option.
+- Add a `default_storage_class` configuration for the S3 service: Configuration is specific to the S3 service.
+- Add an option for `content_type` in the `write` operation: It aligns with HTTP standards.
 
-- Add a new option in read for `storage_class`: Bad, as different services could have varying values for this parameter.
+We don't
+- Add a new option in read for `storage_class`: As different services could have varying values for this parameter.
 
 ## 3. Free to integrate
 
@@ -42,8 +44,9 @@ OpenDAL needs to be integrated with different systems.
 
 ### Examples
 
-- Add python binding: Good, users from `python` can use OpenDAL.
-- Add object_store integration: Good, users of `object_store` can adopt OpenDAL.
+We
+- Add python binding: users from `python` can use OpenDAL.
+- Add object_store integration: users of `object_store` can adopt OpenDAL.
 
 ## 4. Free to zero cost
 
@@ -54,8 +57,9 @@ OpenDAL needs to implement features in zero cost way which means:
 
 ### Examples
 
-- Add `layer` support: Good, users can add logging/metrics/tracing in zero cost way.
-- Implement `seek` for Reader: Good, users can't write better `seek` support, they all need to pay the same cost.
-
+We
+- Add `layer` support: Users can add logging/metrics/tracing in zero cost way.
+- Implement `seek` for Reader: Users can't write better `seek` support, they all need to pay the same cost.
 
-- Add `Arc` for metadata: Bad, users may only need to use metadata once and never clone it. For those who do want this feature, they can add `Arc` themselves.
+We don't
+- Add `Arc` for metadata: Users may only need to use metadata once and never clone it. For those who do want this feature, they can add `Arc` themselves.