Xuanwo commented on code in PR #2094: URL: https://github.com/apache/incubator-opendal/pull/2094#discussion_r1175391561
########## core/src/docs/concepts.rs: ########## @@ -17,20 +17,26 @@ //! The core concepts of OpenDAL's public API. //! -//! OpenDAL provides a unified abstraction for all storage services. +//! OpenDAL provides a unified abstraction that helps developers access all storage services. //! //! There are two core concepts in OpenDAL: //! -//! - [`Builder`]: Build an instance of underlying services. -//! - [`Operator`]: A bridge between underlying implementation detail and unified abstraction. +//! - [`Builder`]: Builder accepts a series of parameters to set up an instance of underlying services. +//! You can adjust the behaviour of underlying services with these parameters. +//! - [`Operator`]: Developer can access underlying storage services with manipulating one Operator. +//! The Operator is a delegate for underlying implementation detail, and provides one unified access interface, +//! including `read`, `write`, `list` and so on. +//! Through Operators, OpenDAL standardizes the access methods of different storage services into access to a file system-like interface. Review Comment: > so what is the actual goal? OpenDAL's VISION is: `access data freely`. More details could be found at https://opendal.apache.org/docs/vision. We design our API is to match our VISION and not related or adhere to `file system-like API`. They are different things. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
