m2k: Restructure and add content

[StancaPop]

Type

• Documentation
• Bug fix
• New feature
• Continuous integration

Checklist

• I have performed a self-review of changes
• I have followed the guidelines:
  • https://analogdevicesinc.github.io/documentation/contributing/docs_guidelines.html
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/index.html
  • https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#documentation-structure
• I have used the appropriate roles and directives:
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/roles.html
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/directives.html
• I ensured that binary data was committed to git lfs:
  • https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#adding-images-and-other-binary-files
• I have built the pages I edited or created, using either make html or adoc serve:
  • https://analogdevicesinc.github.io/doctools/cli.html#serve
• I have signed-off my commits and believe my contribution improves the repository.

[thorenscientific]

@StancaPop looks like the page build is failing. Once that's fixed I'd be happy to give this a read (as a heavy user of the "little blue wonder" m2k!)

[thorenscientific]

Re: Vale error - Yes, Nyquist is conventionally capitalized.

[thorenscientific]

Re: Vale error - yes, Adafruit is the name of a company.

[thorenscientific]

@StancaPop - comments / suggestions:

Not sure how the ordering of the left-hand menu is handled - through that level's index.rst? A more logical ordering would be:

• ADALM2000
  • Introduction to the ADALM2000
  • For End Users (and its child pages)
  • For Developers
  • Using with MATLAB
  • Using with LabVIEW
  • Support

It looks like the labview.rst and intro.rst are at the same level as index.rst - does this make sense, or should these be placed in child folders?

I see there are still a few references to wiki pages - that's fine for now. But one to migrate as part of this PR would be the https://wiki.analog.com/university/tools/m2k/devs/hardware page, linked from "Schematics" in the "For Developers" page.

Another wiki reference would be the "quick start" https://wiki.analog.com/university/tools/m2k/users/quick_start - which is pretty minimal, and I'd argue so short it might just be better put inline in the For End Users page (snarky "Most people don't read instructions, and just want get things going: comment and all :) )

In the reference manual (reference_manual.rst) - the figures from images/ad9963.png and down could probably be bumped to 600px width. At some point we should probably re-take all of the schematic screenshots, but let's keep as-is for now.

If we can take care of these things, let's go ahead with this, and make sure to put redirect notes in the corresponding wiki pages.

[gastmaier]

Force pushed to resolve conflict triggered by rebase only (merge commit succeeded)

$ git pull public main --rebase

CONFLICT (rename/delete): docs/tools/m2k/windows-eject.png renamed to docs/tools/m2k/images/windows-eject.png in b90973ed0 (m2k: Restructure and add content), but deleted in HEAD.

the solution was to delete, since is not used anywhere (and that is the reason it does not exist in main anymore)