UPDATE: First commit with the new documentation

docs/src/functions/financial.md

@@ -0,0 +1,63 @@
+---
+layout: doc
+outline: deep
+lang: en-US
+---
+
+# Financial functions
+
+- ACCRINT
+- ACCRINTM
+- AMORDEGRC
+- AMORLINC
+- COUPDAYBS
+- COUPDAYS
+- COUPDAYSNC
+- COUPNCD
+- COUPNUM
+- COUPPCD
+- CUMIPMT
+- CUMPRINC
+- DB
+- DDB
+- DISC
+- DOLLARDE
+- DOLLARFR
+- DURATION
+- EFFECT
+- [FV](/functions/financial/fv)
+- FVSCHEDULE
+- INTRATE
+- IPMT
+- IRR
+- ISPMT
+- MDURATION
+- MIRR
+- NOMINAL
+- NPER
+- NPV
+- ODDFPRICE
+- ODDFYIELD
+- ODDLPRICE
+- ODDLYIELD
+- PDURATION
+- PMT
+- PPMT
+- PRICE
+- PRICEDISC
+- PRICEMAT
+- PV
+- RATE
+- RECEIVED
+- RRI
+- SLN
+- SYD
+- TBILLEQ
+- TBILLPRICE
+- TBILLYIELD
+- VDB
+- XIRR
+- XNPV
+- YIELD
+- YIELDDISC
+- YIELDMAT

docs/src/functions/financial/fv.md

@@ -0,0 +1,60 @@
+---
+layout: doc
+outline: deep
+lang: en-US
+---
+
+# FV function
+
+## Overview
+
+FV (<u>F</u>uture <u>V</u>alue) is a function in the Financial category that can be used to predict the future value of an investment or asset based on its present value.
+
+FV can be used to calculate future value over a specified number of compounding periods. A fixed interest rate or yield is assumed over all periods, and a fixed payment or deposit can be applied at the start or end of every period.
+
+If your interest rate varies between periods, use the FVSCHEDULE function (<span style="color:orange">link when page written</span>) instead of FV.
+
+## Parameters
+
+**FV(rate, nper, pmt, pv, period_start)**
+
+- _rate_. The fixed percentage interest rate or yield per period.
+- _nper_. The number of compounding periods to be taken into account. While this will often be an integer, non-integer values are also accepted.
+- _pmt_ (optional). The fixed amount paid or deposited each compounding period (default 0).
+- _pv_ (optional). The present value or starting amount of the asset (default 0).
+- _period_start_ (optional). A logical value indicating whether the payment due dates are at the end (0) of the compounding periods or at the beginning (1) (default 0). FV treats any non-zero value as it would the value 1.
+
+### Additional notes
+
+- FV may generate #ERROR!, #VALUE! or #DIV/0! errors. For more details see our Error Types page (<span style="color:orange">link when page written</span>).
+- Make sure that the _rate_ argument specifies the interest rate or yield applicable to the compounding period, based on the value chosen for _nper_.
+- The _pmt_ and _pv_ arguments should be expressed in the same currency unit. FV returns a value in the same currency unit.
+- To ensure a worthwhile result, one of the _pmt_ and _pv_ arguments should be set to a non-zero value.
+- The setting of the _period_start_ argument only affects the calculation for non-zero values of the _pmt_ argument.
+
+## Details
+
+- If _rate_ = 0, FV solves the equation:
+
+  $$
+  FV = -pv - (pmt \times nper)
+  $$
+
+- If _rate_ <> 0 and _period_start_ = 0, FV solves the equation:
+  $$
+  FV = -pv \times (1 + rate)^{nper} - \dfrac{pmt\times\big({(1+rate)^{nper}-1}\big)}{rate}
+  $$
+- If _rate_ <> 0 and _period_start_ <> 0, FV solves the equation:
+  $$
+  FV = -pv \times (1 + rate)^{nper} - \dfrac{pmt\times\big({(1+rate)^{nper}-1}\big) \times(1+rate)}{rate}
+  $$
+
+## Examples
+
+<span style="color:orange">Embed file - FV function examples.xlsx</span>.
+
+## Links
+
+- For more information about the concept of "future value" in finance, visit Wikipedia's [Future value](https://en.wikipedia.org/wiki/Future_value) page.
+
+- Visit Microsoft Excel's [FV function](https://support.microsoft.com/en-gb/office/fv-function-2eef9f44-a084-4c61-bdd8-4fe4bb1b71b3) page.