From c4a9a79be08fdc26865ac23b53879b81076f3c3f Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 4 Jul 2020 09:43:49 +0200
Subject: [PATCH] Apply suggested documentation changes from code review

Co-authored-by: hroff-1902 <47309513+hroff-1902@users.noreply.github.com>
---
 docs/bot-basics.md              |  4 ++--
 docs/strategy-advanced.md       | 12 ++++++------
 docs/strategy-customization.md  |  4 ++--
 freqtrade/strategy/interface.py |  2 +-
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/bot-basics.md b/docs/bot-basics.md
index 728dcf46e..44f493456 100644
--- a/docs/bot-basics.md
+++ b/docs/bot-basics.md
@@ -1,10 +1,10 @@
 # Freqtrade basics
 
-This page will try to teach you some basic concepts on how freqtrade works and operates.
+This page provides you some basic concepts on how Freqtrade works and operates.
 
 ## Freqtrade terminology
 
-* Trade: Open position
+* Trade: Open position.
 * Open Order: Order which is currently placed on the exchange, and is not yet complete.
 * Pair: Tradable pair, usually in the format of Quote/Base (e.g. XRP/USDT).
 * Timeframe: Candle length to use (e.g. `"5m"`, `"1h"`, ...).
diff --git a/docs/strategy-advanced.md b/docs/strategy-advanced.md
index c576cb46e..a5977e5dc 100644
--- a/docs/strategy-advanced.md
+++ b/docs/strategy-advanced.md
@@ -3,7 +3,7 @@
 This page explains some advanced concepts available for strategies.
 If you're just getting started, please be familiar with the methods described in the [Strategy Customization](strategy-customization.md) documentation and with the [Freqtrade basics](bot-basics.md) first.
 
-[Freqtrade basics](bot-basics.md) describes in which sequence each method defined below is called, which can be helpful to understand which method to use.
+[Freqtrade basics](bot-basics.md) describes in which sequence each method described below is called, which can be helpful to understand which method to use for your custom needs.
 
 !!! Note
     All callback methods described below should only be implemented in a strategy if they are also actively used.
@@ -97,8 +97,8 @@ class Awesomestrategy(IStrategy):
 
 ## Bot loop start callback
 
-A simple callback which is called at the start of every bot iteration.
-This can be used to perform calculations which are pair independent.
+A simple callback which is called once at the start of every bot throttling iteration.
+This can be used to perform calculations which are pair independent (apply to all pairs), loading of external data, etc.
 
 ``` python
 import requests
@@ -111,7 +111,7 @@ class Awesomestrategy(IStrategy):
         """
         Called at the start of the bot iteration (one loop).
         Might be used to perform pair-independent tasks
-        (e.g. gather some remote ressource for comparison)
+        (e.g. gather some remote resource for comparison)
         :param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
         """
         if self.config['runmode'].value in ('live', 'dry_run'):
@@ -125,7 +125,7 @@ class Awesomestrategy(IStrategy):
 
 ### Trade entry (buy order) confirmation
 
-`confirm_trade_entry()` an be used to abort a trade entry at the latest second (maybe because the price is not what we expect).
+`confirm_trade_entry()` can be used to abort a trade entry at the latest second (maybe because the price is not what we expect).
 
 ``` python
 class Awesomestrategy(IStrategy):
@@ -158,7 +158,7 @@ class Awesomestrategy(IStrategy):
 
 ### Trade exit (sell order) confirmation
 
-`confirm_trade_exit()` an be used to abort a trade exit (sell) at the latest second (maybe because the price is not what we expect).
+`confirm_trade_exit()` can be used to abort a trade exit (sell) at the latest second (maybe because the price is not what we expect).
 
 ``` python
 from freqtrade.persistence import Trade
diff --git a/docs/strategy-customization.md b/docs/strategy-customization.md
index 0a1049f3b..50fec79dc 100644
--- a/docs/strategy-customization.md
+++ b/docs/strategy-customization.md
@@ -1,8 +1,8 @@
 # Strategy Customization
 
-This page explains how to customize your strategies, and add new indicators.
+This page explains how to customize your strategies, add new indicators and set up trading rules.
 
-Please familiarize yourself with [Freqtrade basics](bot-basics.md) first.
+Please familiarize yourself with [Freqtrade basics](bot-basics.md) first, which provides overall info on how the bot operates.
 
 ## Install a custom strategy file
 
diff --git a/freqtrade/strategy/interface.py b/freqtrade/strategy/interface.py
index f8e59ac7b..f3c5e154d 100644
--- a/freqtrade/strategy/interface.py
+++ b/freqtrade/strategy/interface.py
@@ -194,7 +194,7 @@ class IStrategy(ABC):
         """
         Called at the start of the bot iteration (one loop).
         Might be used to perform pair-independent tasks
-        (e.g. gather some remote ressource for comparison)
+        (e.g. gather some remote resource for comparison)
         :param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
         """
         pass