docs: Fix invalid JSON in Stream Maps page and add meltano.yml tabs

[mjsqu]

Resolves #797

---

📚 Documentation preview 📚: https://meltano-sdk--1756.org.readthedocs.build/en/1756/

[codecov]

Codecov Report

Merging #1756 (fbf40d7) into main (d27f8ad) will not change coverage.
The diff coverage is n/a.

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

@@           Coverage Diff           @@
##             main    #1756   +/-   ##
=======================================
  Coverage   86.12%   86.12%           
=======================================
  Files          59       59           
  Lines        4944     4944           
  Branches      809      809           
=======================================
  Hits         4258     4258           
  Misses        485      485           
  Partials      201      201           

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[mjsqu]

Quick link to the changed page:
https://meltano-sdk--1756.org.readthedocs.build/en/1756/stream_maps.html

[mjsqu]

Just shifted the meltano.yml tabs first, makes more sense as the tabs with the comments are displayed first - the JSON without comments can be viewed optionally

[pnadolny13]

@mjsqu these tabs look so good, thanks for the PR!

The only thing I'm still unclear on is null handling in the meltano.yml files. I know theres an option to include __NULL__ or I guess in my case I ended up leaving it empty to represent null instead of the actual null keyword. @edgarrmondragon can you clarify the best way to represent these in the docs?

[edgarrmondragon]

@mjsqu these tabs look so good, thanks for the PR!

The only thing I'm still unclear on is null handling in the meltano.yml files. I know theres an option to include __NULL__ or I guess in my case I ended up leaving it empty to represent null instead of the actual null keyword. @edgarrmondragon can you clarify the best way to represent these in the docs?

@pnadolny13 good catch! It's probably just better to use __NULL__ in all the meltano.yml examples to save users any potential issues around Meltano's handling of null values.

[edgarrmondragon]

Thanks @mjsqu! I've suggested some changes.

[mjsqu]

Having some problems running poetry lock:

[mjsqu]

Uh - I thought a poetry lock run was suggested, but I can't find that comment now 😆

[edgarrmondragon]

Uh - I thought a poetry lock run was suggested, but I can't find that comment now 😆

Lol, it's here: #1756 (comment)

Having some problems running poetry lock:

Oh, bummer. The tabs plugin requires Python 3.8+ 😭. That means #1659 is a blocker for this.

[edgarrmondragon]

Oh, bummer. The tabs plugin requires Python 3.8+ 😭. That means #1659 is a blocker for this.

On second thought, RTD uses Python 3.11 to build the docs so using an env marker for the dependency should be fine.