docs: update yacl docs (#516)

Author: changtong9

STANDARDS.md

@@ -0,0 +1,45 @@
+# Supported Cryptographic Standards
+
+This library provides full implementation of the following NIST-standardized cryptography specifications:
+
+## **Core Algorithms**
+- **AES** (FIPS 197)  
+
+- **SM3** (GM/T 0004-2012)
+
+- **SM4** (GM/T 0002-2012)
+
+- **SHA2/SHA3 Family** (FIPS 180-4, FIPS 202)  
+
+- **HMAC** (FIPS 198-1)  
+
+- **KMAC** (SP 800-56B)  
+
+## **Post-Quantum Cryptography**
+- **ML-KEM** (FIPS 203)  
+
+- **ML-DSA** (FIPS 204)  
+
+## **Digital Signatures**
+- **DSA** (FIPS 186)  
+
+## Public Key Cryptography
+- **RSA**  (SP 800-185)
+
+## **Elliptic Curve Cryptography**
+- **ECC** (GM/T 0003-2012, FIPS 186-4, RFC 7748, RFC 8032)
+- **Hash-to-Curve** (RFC 9380)  
+
+## **Secure Randomness**
+- **Hash-DRBG** (SP 800-90A)  
+ 
+- **CTR-DRBG** (SP 800-90A)  
+ 
+- **Entropy Sources** (SP 800-90B)
+
+## **Authenticated Encryption**
+- **AES-GCM** (SP 800-38D)  
+ 
+- **AEAD** (RFC 5116)  
+
+---

docs/imgs/yacl_arch.png

@@ -7,6 +7,10 @@ YACL (Yet Another Common Cryptography Library) is a sub-project of `SecretFlow <
 - **About Network ("link") Modules:** The network ("link") module in Yacl uses `BRPC <https://brpc.apache.org/>`_ to handle network. And we also provide a "mocked" in-memory link.
 - **About IO Modules:** Yacl also provides many io modules for kv storage, file io, `bristol circuits <https://nigelsmart.github.io/MPC-Circuits/>`_, and so on.
 
+.. image:: ./imgs/yacl_arch.png
+  :width: 800
+  :alt: Alternative text
+
 The following parts describes the top-level folders of Yacl repository.
 
 - `yacl/base/ <https://github.com/secretflow/yacl/tree/main/yacl/base>`_: some basic types and utils in yacl.

docs/index.rst

@@ -3,7 +3,7 @@ Develop
 
 **For Traditioanl PKI:** Since there are so many existing time-proof, efficient, and standardized implementation of PKI algorithms, Yacl **does not re-implement** those algorithms. Instead, Yacl only provides a light-weighted and "easy-to-use" wrapper for the most popular industrial libraries (e.g. `OpenSSL <https://openssl.org/>`_, `TongSuo <https://github.com/Tongsuo-Project>`_, `LibSodium <https://doc.libsodium.org/>`_, etc.)
 
-**For ECC (Elliptic-Curve Cryptography):** Yacl integrates many curve implementation from OpenSSL, you may use the code in the following to use any curve as you like. For more information about all supported curve names, see: `yacl/crypto/ecc/curve_meta.cc <https://github.com/secretflow/yacl/blob/main/yacl/crypto/ecc/curve_meta.cc>`_
+**For ECC (Elliptic-Curve Cryptography):** Yacl integrates many curve implementation from OpenSSL, MCL, LibSodium and other libraries, you may use the code in the following to use any curve as you like. For more information about all supported curve names, see: `yacl/crypto/ecc/curve_meta.cc <https://github.com/secretflow/yacl/blob/main/yacl/crypto/ecc/curve_meta.cc>`_
 
 .. code-block:: cpp
 
@@ -21,6 +21,19 @@ Develop
    //     ec->Mul(/* first point */, /* second scalar */);
    //     ... for more see: yacl/crypto/ecc/ecc_spi.h
 
+**For Hashing:** Yacl provides various hash functions, such as SHA256, SM3, Blake3, Shake256 and so on. You can use the code in the following to hash your data. For more information about all supported hash functions, see: `yacl/crypto/hash/hash_utils.cc <https://github.com/secretflow/yacl/blob/main/yacl/crypto/hash/hash_utils.cc>`_
+
+.. code-block:: cpp
+
+   #include "yacl/crypto/hash/hash_utils.h"
+
+   auto sha256_hash = yacl::crypto::Sha256(/* your data */);
+   auto sm3_hash = yacl::crypto::Sm3(/* your data */);
+
+   // You can also use the following to hash your data
+   // auto sha256_hash = yacl::crypto::SslHash(HashAlgorithm::SHA256).Update(/* your data */).CumulativeHash();
+   // ... for more see: yacl/crypto/hash/hash_utils.h and yacl/crypto/hash/ssl_hash.h
+
 **For Randomness** Yacl has also provide some easy-to-use randomness generation functions. Random functions usually start with **Secure** or **Fast**, secure random implementation uses the standardized ctr-drbg, and fast uses hash-drbg. It is always recommended to use **Secure**-Random functions.
 
 .. code-block:: cpp

docs/src/develop/index.rst

@@ -0,0 +1,2 @@
+.. include:: ../../STANDARDS.md
+   :parser: myst_parser.sphinx_