Yansongsongsong commented on code in PR #2094: URL: https://github.com/apache/incubator-opendal/pull/2094#discussion_r1175420170
########## 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: sorry no offense for this. just feel confused when read doc and code. Thank you again for your review -- 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]
