diff --git a/oracles/chainlink.md b/oracles/chainlink.md
index 70a3583..40dc241 100644
--- a/oracles/chainlink.md
+++ b/oracles/chainlink.md
@@ -2,12 +2,19 @@
-A decentralized oracle network consisting of three key smart contracts:
+### tl; dr
-* a reputation contract: keep track of data providers' performance.
-* an order-matching contract: selects bids from oracles using the reputation contract.
-* an aggregation contract—and an off-chain registry of data providers.
+
+* a decentralized oracle network consisting of three key smart contracts:
+ * a reputation contract: keep track of data providers' performance.
+ * an order-matching contract: selects bids from oracles using the reputation contract.
+ * an aggregation contract—and an off-chain registry of data providers.
+* one of the main challenges with such a decentralized approach is the formulation of the aggregation function.
+* chainlink proposes calculating a weighted response, allowing a validity score to be reported for each oracle response.
-One of the main challenges with such a decentralized approach is the formulation of the aggregation function.
-ChainLink proposes calculating a weighted response, allowing a validity score to be reported for each oracle response.
+
+
+---
+
+### resources