Merge pull request #44 from morpho-org/fix/docs-72

src/ChainlinkOracle.sol

@@ -35,6 +35,13 @@ contract ChainlinkOracle is IOracle {
 
     /* CONSTRUCTOR */
 
+    /// @dev Here is the list of assumptions on the inputs that guarantees the oracle behaves as expected:
+    /// - Feeds are either Chainlink-compliant or the address zero.
+    /// - Feeds have the same behavioral assumptions as Chainlink's.
+    /// - Feeds are set in the correct order.
+    /// - Decimals passed as argument are correct.
+    /// - The vault conversion sample is low enough to avoid overflows.
+    /// - The vault, if set, is ERC4626-compliant.
     /// @param vault Vault. Pass address zero to omit this parameter.
     /// @param baseFeed1 First base feed. Pass address zero if the price = 1.
     /// @param baseFeed2 Second base feed. Pass address zero if the price = 1.

src/libraries/ChainlinkDataFeedLib.sol

@@ -13,6 +13,7 @@ library ChainlinkDataFeedLib {
     /// @dev Performs safety checks and returns the latest price of a `feed`.
     /// @dev When `feed` is the address zero, returns 1.
     /// @dev Notes on safety checks:
+    /// - L2s are not supported.
     /// - Staleness is not checked because it's assumed that the Chainlink feed keeps its promises on this.
     /// - The price is not checked to be in the min/max bounds because it's assumed that the Chainlink feed keeps its
     /// promises on this.