docs: large documentation update. Add examples, add specs, add scripts

[skoudoro]

All in the title above.

• fix Documentation examples #79
• zero warnings allowed during docs generation.
• mutliple functions docstring normalized to the Numpy Stantard

Install with all dependencies

pip install -e ".[all]"

Set up development environment (fetches upstream tags)

spin setup

build docs:

spin docs --open --clean

some screenshots:

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (master@43edfbb). Learn more about missing BASE report.

Additional details and impacted files

@@            Coverage Diff            @@
##             master      #90   +/-   ##
=========================================
  Coverage          ?   58.96%           
=========================================
  Files             ?       12           
  Lines             ?     2364           
  Branches          ?        0           
=========================================
  Hits              ?     1394           
  Misses            ?      970           
  Partials          ?        0           

Flag	Coverage Δ
unittests	58.96% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[skoudoro]

ok all green , merging for now.

More update coming concerning the doc