docs(toml): lint @std/toml docs

[littledivy]

No description provided.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.36%. Comparing base (7717c29) to head (ffb98f9).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4799   +/-   ##
=======================================
  Coverage   92.36%   92.36%           
=======================================
  Files         488      488           
  Lines       41603    41603           
  Branches     5409     5409           
=======================================
  Hits        38425    38425           
  Misses       3122     3122           
  Partials       56       56           

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

[lucacasonato]

The docs for this module are still very lacking. Neither parse nor stringify has an example, and the docs are quite poor in general.

[littledivy]

Oh, the lint should probably detect that? I got an error for missing @example in crypto

[lucacasonato]

Yes, I agree it should. See comment at the top of _tools/check_docs.ts: // TODO(iuioiua): Add support for classes and methods. :)

[iuioiua]

Can you please add toml/mod.ts to the file list in the lint:docs task? Ignore - I see we've moved this all into the doc checker now.

[iuioiua]

Can you please use an assertion from std/assert here? It ensures the example is correct. Ditto for other examples.

[kt3k]

Added the assertions

[kt3k]

LGTM

feedbacks are addressed