Fix type hierarchy for CorrectedImageStack, ImagingRetinotopy; improve docs

[rly]

Fixes NeurodataWithoutBorders/nwb-schema#271 and improve documentation

Checklist

• Have you checked our Contributing document?
• Have you ensured the PR description clearly describes problem and the solution?
• Is your contribution compliant with our coding style ? This can be checked running flake8 from the source directory.
• Have you checked to ensure that there aren't other open Pull Requests for the same change?
• Have you included the relevant issue number using #XXX notation where XXX is the issue number ?

[codecov]

Codecov Report

Merging #962 into dev will not change coverage.
The diff coverage is 100%.

@@           Coverage Diff           @@
##              dev     #962   +/-   ##
=======================================
  Coverage   72.93%   72.93%           
=======================================
  Files          36       36           
  Lines        2609     2609           
  Branches      497      497           
=======================================
  Hits         1903     1903           
  Misses        590      590           
  Partials      116      116

Impacted Files	Coverage Δ
src/pynwb/ecephys.py	97.29% <100%> (ø)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update e9bf8d5...affb676. Read the comment docs.

[codecov]

Codecov Report

❗ No coverage uploaded for pull request base (dev@565ba8a). Click here to learn what that means.
The diff coverage is 100%.

@@          Coverage Diff           @@
##             dev     #962   +/-   ##
======================================
  Coverage       ?   73.24%           
======================================
  Files          ?       36           
  Lines          ?     2616           
  Branches       ?      496           
======================================
  Hits           ?     1916           
  Misses         ?      584           
  Partials       ?      116

Impacted Files	Coverage Δ
src/pynwb/ecephys.py	97.29% <100%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 565ba8a...42b8c54. Read the comment docs.

[oruebel]

You should also update the patch version of the namespace, i.e., 2.0.x to 2.0.(x+1) since your are changing the schema.

In NeurodataWithoutBorders/nwb-schema#271 you should then also update the release of the nwb-schema docs.

Luckily, NWBDataInterface does not any fields so this change should not affect compatability.

[rly]

Regarding updated author list, see also updates to nwb-schema: NeurodataWithoutBorders/nwb-schema#265 and NeurodataWithoutBorders/nwb-schema#266

[oruebel]

I forgot #953 also changes the version, i.e., depending on the order these get merged we may need to update the version again.

Also t-b discovered in #953 another issue with the version in that we need to update the value of the nwb_version attribute in nwb.file.yaml as well. While this is a separate issue that we should fix, we should in the meantime make sure to update both until we have fixed the problem with having nwb_version as attribute in the schema.

[rly]

Can we put all of these schema changes under 2.0.2 or should they be kept separate?

[rly]

#822 and #825 seem ready to merge with an update to the schema as well.

[oruebel]

Can we put all of these schema changes under 2.0.2 or should they be kept separate?

Putting #953 and this PR under the 2.0.2 umbrella seems fine. #822 and #825 add new functionality and should be part of a separate version jump.

#822 and #825 seem ready to merge with an update to the schema as well.

I remember we had some discussions about those PRs, which is why we did not merge those yet, but I don't recall what the issue was. @ajtritt do you recall if #822 and #825 were good to merge now?