diff --git a/discovery/README.md b/discovery/README.md
index 77d0d902f0f..d2d936f5988 100644
--- a/discovery/README.md
+++ b/discovery/README.md
@@ -2,6 +2,28 @@
This menu aims to discover new stocks, and the usage of the following commands along with an example will be exploited below.
+ * [map](#map)
+ - S&P500 index stocks map [Finviz]
+ * [sectors](#sectors)
+ - show sectors performance [Alpha Vantage]
+ * [gainers](#gainers)
+ - show latest top gainers [Yahoo Finance]
+ * [orders](#orders)
+ - orders by Fidelity Customers [Fidelity]
+ * [earnings](#earnings)
+ - next earnings release dates [Seeking Alpha]
+ * [high_short](#high_short)
+ - show top high short interest stocks of over 20% ratio [www.highshortinterest.com]
+ * [low_float](#low_float)
+ - show low float stocks under 10M shares float [www.lowfloat.com]
+ * [sw](#sw)
+ - Simply Wall St. research data [Simply Wall St.]
+ * [spachero](#spachero)
+ - best website for SPACs research [SpacHero]
+ * [uwhales](#uwhales)
+ - good website for SPACs research [UnusualWhales]
+
+
```
map S&P500 index stocks map [Finviz]
sectors show sectors performance [Alpha Vantage]
@@ -15,22 +37,33 @@ spachero best website for SPACs research [SpacHero]
uwhales good website for SPACs research [UnusualWhales]
```
-## map
+## map
-## sectors
+```
+usage: map [-p {1d,1w,1m,3m,6m,1y}] [-t {sp500,world,full,etf}]
+```
+Performance index stocks map categorized by sectors and industries. Size represents market cap. Opens web-browser. [Source: Finviz]
+ * -p : Performance period. Default 1 day.
+ * -t : Map filter type. Default S&P500.
-## gainers
+Example:
+
-## orders
-## earnings
+## sectors
-## high_short
+## gainers
-## low_float
+## orders
-## sw
+## earnings
-## spachero
+## high_short
-## uwhales
+## low_float
+
+## sw
+
+## spachero
+
+## uwhales