Refactor the documentation

[rlouf]

• Do we keep the d3viz stuff?
• Do we keep the stuff about multicore support?
• How to interpret the outputs of dprint
• Reference for decorated functions (rewrites): See what Celery has done. There doesn't seem to be any easy way to do it.
• Make sure the list of tensor operation is exhaustive
• NumPy comparison
• Scan diagram

Structure

What is Aesara?
Mission
Installing Aesara
Get help
Working with Aesara
    Building Aesara graphs
    Compiling
    Serializing
    Troubleshoot
Understanding Aesara
    Aesara graphs
    Compilation
    Rewrites
Extending Aesara

[brandonwillard]

Why the change from "Extending Aesara" to "Extend Aesara"? The former seems a little clearer to me regarding the subject matter of the content.

[codecov]

Codecov Report

Merging #1413 (95849b0) into main (2f9a9e6) will decrease coverage by 0.01%.
The diff coverage is n/a.

❗ Current head 95849b0 differs from pull request most recent head ea6accc. Consider uploading reports for the commit ea6accc to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1413      +/-   ##
==========================================
- Coverage   74.72%   74.72%   -0.01%     
==========================================
  Files         194      194              
  Lines       49877    49866      -11     
  Branches    10549    10549              
==========================================
- Hits        37273    37262      -11     
  Misses      10274    10274              
  Partials     2330     2330              

Impacted Files	Coverage Δ
aesara/tensor/type.py	90.95% <ø> (ø)
aesara/tensor/var.py	87.82% <ø> (ø)
aesara/scalar/basic.py	79.02% <0.00%> (-0.02%)	⬇️
aesara/tensor/random/basic.py	99.03% <0.00%> (-0.02%)	⬇️
aesara/tensor/rewriting/math.py	85.95% <0.00%> (ø)

[dgerlanc]

I'd vote "no" on d3viz.

Where is the multicore stuff?

[rlouf]

Yeah I don't think we want to maintain the D3 viz module at all. The multi core stuff was just two paragraphs with not much information in it, I ended up removing it.