fixes type restriction on input arguments and Improve docs

[lazarusA]

This adds 3 main things

1. less restrictive type input arguments, no restrictions
2. improved documentation
3. YAXArray example with mapCube (for out of memory calculations)

I didn't and will not look at the auto formatting issues, please feel free to do so. CI or additional comments I would consider. This was a good sprint. Cheers!

[MartinuzziFrancesco]

should the documenter github action be removed? if not could you look into the cause of failure?

[lazarusA]

yeah, it looks like that's the issue. Apparently, I'm not up to date with deploy workflow. Let's see if it works now.

[MartinuzziFrancesco]

that did it apparently

[lazarusA]

the only thing missing is the formatter. How to you do it? what's the workflow to apply that. I usually don't enforce it, hence I'm not familiar with it.

[codecov]

Codecov Report

Attention: Patch coverage is 99.73475% with 1 lines in your changes are missing coverage. Please review.

Project coverage is 92.22%. Comparing base (ed6e091) to head (c8ac13c).

Files	Patch %	Lines
src/utils.jl	0.00%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #52   +/-   ##
=======================================
  Coverage   92.22%   92.22%           
=======================================
  Files          12       12           
  Lines         900      900           
=======================================
  Hits          830      830           
  Misses         70       70           

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

[MartinuzziFrancesco]

I should have added an automatic formatter actually, I'm curios to see if it works. It should open a pr with the formatted code. If that doesn't work I'll just format myself