diff options
author | Danglewood <85772166+deeleeramone@users.noreply.github.com> | 2024-05-22 06:50:43 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-05-22 13:50:43 +0000 |
commit | 3a8a71dd1551d23036d023a8153c7ced207a562c (patch) | |
tree | 8bf671d0416d1721e832757a7ec1e475cf1ec411 | |
parent | 7531e1da4f72d40bf91fd0230d1d11502b3f926d (diff) |
[Docs] Refactor Docs Pages For Diataxis (#6315)
* This change creates a PR
* start moving stuff around
* data_models/_category_.json
* reference/_category_.json
* moving some stuff around
* Introduction
* Documentation updates
* few broken links, clean up sidebar titles for how-to
* codespell
* quickstart - new provider extension
* add a comment
* map provider interface
* quickstart for new router extension
* [Docs] diataxis refactor refactor (#6425)
* Start refactor
* Edits
* [DOCS] Reorganize and edit. Fix sidebar navigation (#6445)
* Reorganize and edit. Fix sidebar navigation
* Fix broken linkages
* Edit
---------
Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com>
* Fix links
---------
Co-authored-by: Theodore Aptekarev <aptekarev@gmail.com>
* Fix broken links
* Reword CLA part in the Licensing FAQ
* change titles and order suggestion - cc @IgorWounds @piiq
---------
Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com>
Co-authored-by: James Maslek <jmaslek11@gmail.com>
Co-authored-by: Theodore Aptekarev <aptekarev@gmail.com>
Co-authored-by: hjoaquim <henriquecjoaquim@gmail.com>
77 files changed, 2630 insertions, 1606 deletions
diff --git a/openbb_platform/CONTRIBUTING.md b/openbb_platform/CONTRIBUTING.md index 62a2806e600..1f041d103e9 100644 --- a/openbb_platform/CONTRIBUTING.md +++ b/openbb_platform/CONTRIBUTING.md @@ -64,7 +64,7 @@ This document provides guidelines for contributing to the OpenBB Platform. Throughout this document, we will be differentiating between two types of contributors: Developers and Contributors. 1. **Developers**: Those who are building new features or extensions for the OpenBB Platform or leveraging the OpenBB Platform. -2. **Contributors**: Those who contribute to the existing codebase, by opening a [Pull Request](#how-to-create-a-pr) thus giving back to the community. +2. **Contributors**: Those who contribute to the existing codebase, by opening a [Pull Request](#getting_started-create-a-pr) thus giving back to the community. **Why is this distinction important?** @@ -676,7 +676,7 @@ When using the OpenBB Platform on a API Interface, the types are a bit more limi The Contributor Guidelines are intended to be a continuation of the [Developer Guidelines](#developer-guidelines). They are not a replacement, but rather an expansion, focusing specifically on those who seek to directly enhance the OpenBB Platform's codebase. It's crucial for Contributors to be familiar with both sets of guidelines to ensure a harmonious and productive engagement with the OpenBB Platform. -There are many ways to contribute to the OpenBB Platform. You can add a [new data point](#how-to-add-a-new-data-point), add a [new command](#openbb-platform-commands), add a [new visualization](/openbb_platform/extensions/charting/README.md), add a [new extension](#how-to-build-openbb-extensions), fix a bug, improve or create documentation, etc. +There are many ways to contribute to the OpenBB Platform. You can add a [new data point](#getting_started-add-a-new-data-point), add a [new command](#openbb-platform-commands), add a [new visualization](/openbb_platform/extensions/charting/README.md), add a [new extension](#getting_started-build-openbb-extensions), fix a bug, improve or create documentation, etc. ### Expectations for Contributors diff --git a/website/content/platform/extensions/charting/examples.md b/openbb_platform/obbject_extensions/charting/examples.md index 87b9918ceed..34a57a8d0c4 100644 --- a/website/content/platform/extensions/charting/examples.md +++ b/openbb_platform/obbject_extensions/charting/examples.md @@ -44,7 +44,7 @@ By default, more than three symbols will draw the chart as cumulative returns fr The tickers below are a collection of State Street Global Advisors SPDR funds, representing S&P 500 components. The data is looking back five years. -``` +```python SPDRS = [ "SPY", "XLE", @@ -162,4 +162,5 @@ create_bar_chart( title="S&P Energy Sector YTD Turnover Rate", ) ``` + ![S&P 500 Energy Sector Turnover Rate](https://github.com/OpenBB-finance/OpenBBTerminal/assets/85772166/4f59eb36-e637-4a54-87ab-e730e43baf8d) diff --git a/website/content/platform/extensions/charting/index.md b/openbb_platform/obbject_extensions/charting/index.md index f55bbe6a8fe..75f6ff10761 100644 --- a/website/content/platform/extensions/charting/index.md +++ b/openbb_platform/obbject_extensions/charting/index.md @@ -339,11 +339,12 @@ The `openbb-charting` extension is equipped with interactive tables, utilizing t data = obb.equity.price.quote("AAPL,MSFT,GOOGL,META,TSLA,AMZN", provider="yfinance") data.charting.table() ``` + ![Interactive Tables](https://github.com/OpenBB-finance/OpenBBTerminal/assets/85772166/77f5f812-b933-4ced-929c-c1e39b2a3eed) External data can also be supplied, providing an opportunity to filter or apply Pandas operations before display. -``` +```python new_df = df.to_df().T new_df.index.name="metric" new_df.columns = new_df.loc["symbol"] diff --git a/website/content/platform/extensions/charting/indicators.md b/openbb_platform/obbject_extensions/charting/indicators.md index 9966ba4571f..9966ba4571f 100644 --- a/website/content/platform/extensions/charting/indica |