docs/new-working-docs: New working docs branch (#5768)

* move old example notebooks to v3 folder, update loadHistoricalPriceData and add findSymbols

* Create README.md

* Update README.md

* Update README.md

* Update README.md

* Vertical diagram instead

* important classes

* core dependencies

* folder structure

* devtools

* swap order

* fix github pages deploy issue

* development index

* delete expectations for developers

* devtools

* obbject stuff

* add

* installation

* hub sync

* idk if i committed already

* add usage page for financial statements

* add link to reference page

* syntax

* numbers

* nearly --> more than

* easier to read code blocks

* codespell

* removing mention to provider

* add 'orientation' for to_dict

* info card for output user preference

* put it in a code block

* correct user_settings.json example

* syntax corrections

* fix sentence

* get rid of floating point mathc

* get rid of other floating point math

* add companion example notebook for financial statements, and new section

* historical prices usage page

* codespell

* add commitment of traders section to usage

* add a note

* codespell

* get rid of equals sign

* Cleanup docs. with @the-praxs

* install

* obbject extend

* spell

* HeadTitle thingies

* Update obbject_extensions.md

* Update obbject_extensions.md

* typo

* Update architectural_considerations.md

* point to the TET pattern

* optional vs required

* reviewing the  patterns. removed the --pre flag under the assumption this will be the final docs for the release cc @deeleeramone

* add a walkthrough

* spelling

* Add more in the introduction

* validator examples

* update Copper-to-Gold notebook example for V4

* Update README.md

* QA Caveats w @the-praxs

* info on class outputs

* merge add data sources and add data points

* disclaimer on cookiecutter

* add missing import to example

* slight syntax change

* missing code block

* missing import

* update intrinio example syntax

* intrinio syntax update

* urls

* core and provider merged

* example syntax

* grammar

* Update API banner link

* quick-fix-docs cc @minhhoang1023

* Update pip install command for v3

* remove --pre note block

* update landing image

---------

Co-authored-by: Henrique Joaquim <h.joaquim@campus.fct.unl.pt>
Co-authored-by: Luqman <luqazino@gmail.com>
Co-authored-by: James Maslek <jmaslek11@gmail.com>
Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com>
Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com>
Co-authored-by: Theodore Aptekarev <aptekarev@gmail.com>
Co-authored-by: Pratyush Shukla <ps4534@nyu.edu>

examples/README.md

@@ -1,18 +1,35 @@
-# Jupyter Notebook Examples Using the OpenBB SDK
+# Jupyter Notebook Examples Using the OpenBB Platform
 
-This folder is a collection of example notebooks that demonstrate some of the ways to get started using the OpenBB SDK.  To run them, ensure that the active kernel selected is the same Python virtual environment where OpenBB was installed.
+This folder is a collection of example notebooks that demonstrate some of the ways to get started with using the OpenBB Platform.  To run them, ensure that the active kernel selected is the same Python virtual environment where OpenBB was installed.
 
 ## Table of Contents
 
+### findSymbols
+
+This notebook provides an introduction to discovering, finding, and searching ticker symbols.
+
+- Search
+- Find company and institutional filings
+- Screen stocks by region and metrics
+
 ### loadHistoricalPriceData
 
-This notebook walks through collecting historical price data using a variety of methods and sources.
+This notebook walks through collecting historical price data, at different intervals, using a variety of sources.
+
+- Loading data with different intervals, and changing sources
+- A brief explanation of ticker symbology
+- Resampling a time series index
+- Some differences between providers, and comparing outputs
+
+### financialStatements
+
+This set of examples introduces financial statements in the OpenBB Platform and compares the free cash flow yields of large-cap retail industry companies.
+
+- Financial statements
+- What to expect with data from different sources
+- Financial attributes
+- Ratios and other metrics
 
-- Loading data with different intervals, and changing sources.
-- A brief explanation of ticker symbology.
-- Using other functions and modules to load data with besides `openbb.stocks.load()`.
-- Gang-loading a list of tickers' price data in a single call.
-- Drawing candle and line charts.
 
 ### copperToGoldRatio
 
@@ -21,56 +38,4 @@ This notebook explains how to calculate and plot the Copper-to-Gold ratio.
 - Loading historical front-month futures prices.
 - Getting the historical series from FRED for the 10-year constant maturity US treasury bill.
 - Performing basic DataFrame operations.
-- Creating OpenBB Figure objects, and plotting on two y-axis.
-
-### realizedVolatilityModels
-
-This notebook demonstrates the six, realized volatility models with in the Technical Analysis module.
-
-- Explore differences between:
-  - Standard Deviation
-  - Parkinson
-  - Hodges-Tompkins
-  - Garman-Klass
-  - Rogers-Satchell
-  - Yang-Zhang
-- Creating and plotting realized volatility cones.
-- Overlaying multiple time series.
-- Use the calculated outputs as inputs to a forecast model.
-
-### usdLiquidityIndex
-
-This notebook demonstrates how to query the Federal Reserve Economic Database and recreate the USD Liquidity Index.
-
-- Search FRED for series IDs.
-- Load multiple series as a single call.
-- Unpacking the data response from the FRED query.
-- Perform arithmetic operations on a DataFrame.
-- Normalization methods for a series or DataFrame.
-- Simple processes for creating charts.
-
-### optionsChains
-
-This notebook demonstrates how to fetch and work with options chains data.
-
-- Use the new method for loading options chains data.
-- Examine the differences of the data, between sources.
-- Calculate and visualize volume and open interest by strike and expiration.
-- Calculate and visualize the Net Delta Exposure, in dollars, by strike and expiration.
-- Visualize the term structure of the implied volatility skew.
-- Get tables with multiple single-leg options strategies.
-
-### googleColabInstallation
-
-This notebook demonstrates how to install the OpenBB SDK within Google Colab.
-
-
-### volumeAtPrice
-
-Volume-at-price is a chart used by technical analysts as a visual gauge to where the trading levels are concentrated, relative to price and volume.  In short, it is the sum of volume at different price levels.  This notebook utilizes individual components of the OpenBB SDK and combines them to build a new view.
-
-- Price
-- Volume
-- VWAP
-- SMA
-- OpenBBFigure
+- Creating charts with Plotly Graph Objects.

examples/v3/README.md

@@ -0,0 +1,79 @@
+# Jupyter Notebook Examples Using the OpenBB SDK
+
+This folder is a collection of example notebooks that demonstrate some of the ways to get started using the OpenBB SDK.  To run them, ensure that the active kernel selected is the same Python virtual environment where OpenBB was installed.
+
+## Table of Contents
+
+:::note
+These examples are for a deprecated version, the code and examples may have bugs and outdated syntax.
+:::
+
+### loadHistoricalPriceData
+
+This notebook walks through collecting historical price data using a variety of methods and sources.
+
+- Loading data with different intervals, and changing sources.
+- A brief explanation of ticker symbology.
+- Using other functions and modules to load data with besides `openbb.stocks.load()`.
+- Gang-loading a list of tickers' price data in a single call.
+- Drawing candle and line charts.
+
+### copperToGoldRatio
+
+This notebook explains how to calculate and plot the Copper-to-Gold ratio.
+
+- Loading historical front-month futures prices.
+- Getting the historical series from FRED for the 10-year constant maturity US treasury bill.
+- Performing basic DataFrame operations.
+- Creating OpenBB Figure objects, and plotting on two y-axis.
+
+### realizedVolatilityModels
+
+This notebook demonstrates the six, realized volatility models with in the Technical Analysis module.
+
+- Explore differences between:
+  - Standard Deviation
+  - Parkinson
+  - Hodges-Tompkins
+  - Garman-Klass
+  - Rogers-Satchell
+  - Yang-Zhang
+- Creating and plotting realized volatility cones.
+- Overlaying multiple time series.
+- Use the calculated outputs as inputs to a forecast model.
+
+### usdLiquidityIndex
+
+This notebook demonstrates how to query the Federal Reserve Economic Database and recreate the USD Liquidity Index.
+
+- Search FRED for series IDs.
+- Load multiple series as a single call.
+- Unpacking the data response from the FRED query.
+- Perform arithmetic operations on a DataFrame.
+- Normalization methods for a series or DataFrame.
+- Simple processes for creating charts.
+
+### optionsChains
+
+This notebook demonstrates how to fetch and work with options chains data.
+
+- Use the new method for loading options chains data.
+- Examine the differences of the data, between sources.
+- Calculate and visualize volume and open interest by strike and expiration.
+- Calculate and visualize the Net Delta Exposure, in dollars, by strike and expiration.
+- Visualize the term structure of the implied volatility skew.
+- Get tables with multiple single-leg options strategies.
+
+### googleColabInstallation
+
+This notebook demonstrates how to install the OpenBB SDK within Google Colab.
+
+### volumeAtPrice
+
+Volume-at-price is a chart used by technical analysts as a visual gauge to where the trading levels are concentrated, relative to price and volume.  In short, it is the sum of volume at different price levels.  This notebook utilizes individual components of the OpenBB SDK and combines them to build a new view.
+
+- Price
+- Volume
+- VWAP
+- SMA
+- OpenBBFigure