* rename `doc` -> `docs`

* merge with old docs

* restructure and convert to `.md`

* fix module errors

* fix imported method docstrings for components

* api: components

* add new logos

* add FAQ section

* rename to `.md`

* move example notebooks to docs

* add config and assets

* updated logos

* setup readthedocs

* add graph view

* fix graph view

* added argref for pr links

* add copyright and clean up `CITATION.cff`

* move release-notes

* better header refs

* more docs, formatting, added hook and handle dynamic docstrings

* remove placeholder

* rename old doc files

* restructure network components attributes and methods

* restructure descriptors and more docs

* wip

* chore: make `n.model`/`n.objective`/`n.objective_constant` read-only attributes

* fix: types

* fix: tests

* docs: finalize draft

* fix: types

* fix: `pf.logger` access

* docs: move file to new `.md` path

* docs: rename files

* fix: docs build warnings

docs: more settings fine tuning

fix: install PyPSA from `new-opt` branch

clean opf doc

add docs for stochastic opt

fix: formatting math form

fix: solve doc warning problems and enable notebook build

docs: make stoch example compatible with 5e892ad

fix: now, compatible

docs: improve theoretical foundation of SP, reference Birge 1982

docs: make docs compatible with 401f641

docs: update scaling properties in stoch opt docs

fix: execute notebooks

fix: typos

* add example notebook showcasing new MGA functionality

* expand the user guide section on MGA

* Don't log optimizer output to console

Reduces visual noise in notebook cell outputs

* fix: conflict

---------

Co-authored-by: lkstrp <[email protected]>

* revise electricity market example

* revise screening curve example

* revise electric vehicle example

* revise carbon management example

* remove capacity constraint per bus example

* revise chained hydro example

* revise transformer example

* revise redispatch example

* revise redispatch example

* revise islanded fuel production example

* revise unit commitment example

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* revise CHP examples

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* revise heat pump / thermal storage example

* remove duplicated lopf-with-heating example

* revise storage_unit vs link/store example

* revise power flow example

* revise AC-DC meshed example

* revise basic MGA example

* revise SCLOPF example

* revise SciGRID example

* revise sector-coupling example

* revise pathway example

* remove accidental file addition

* pre-commit fixes

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

* add modular expansion example

* pre-commit fixes

* add demand elasticity example

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

* Created negative prices due to KVL/congestion example based on Kyri Baker's 3 node grid

* minor adjustments

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Fixed small typo ($)

---------

Co-authored-by: Fabian Neumann <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

…ed) (#1376)

* Finalised explore docs.

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

* Restructured plotting sections.

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

* fix: gc for primary energy in myopic pathway

* Disable allow_errors for mkdocs-jupyter

---------

Co-authored-by: Lukas Trippe <[email protected]>

* YoTwo's licence magic

* add badge

* get the badge

* fix: code of conduct

* add to docs footer

* fix: fatal formatting issue

---------

Co-authored-by: lkstrp <[email protected]>

…recations

Added text related to Excel i/o.

Co-authored-by: lkstrp <[email protected]>