ci: add a cargo doc job

[dj8yfo]

resolves #1264

failed job due to warnings raised looks like this https://github.com/near/near-sdk-rs/actions/runs/12121010891/job/33791012532

[dj8yfo]

this change somehow results in this section

rendered correctly vs

at https://docs.rs/near-contract-standards/5.6.0/near_contract_standards/fungible_token/index.html

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 80.20%. Comparing base (da3f1f4) to head (3de9b54).
Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1269   +/-   ##
=======================================
  Coverage   80.20%   80.20%           
=======================================
  Files         102      102           
  Lines       14598    14598           
=======================================
  Hits        11708    11708           
  Misses       2890     2890           

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

[dj8yfo]

@race-of-sloths include

[race-of-sloths]

@dj8yfo Thank you for your contribution! Your pull request is now a part of the Race of Sloths!

Current status: executed

Reviewer	Score
@akorchyn	5

Your contribution is much appreciated with a final score of 5!
You have received 58 (50 base + 15% lifetime bonus) Sloth points for this contribution

@akorchyn received 25 Sloth Points for reviewing and scoring this pull request.

What is the Race of Sloths

Race of Sloths is a friendly competition where you can participate in challenges and compete with other open-source contributors within your normal workflow

For contributors:

• Tag @race-of-sloths inside your pull requests
• Wait for the maintainer to review and score your pull request
• Check out your position in the Leaderboard
• Keep weekly and monthly streaks to reach higher positions
• Boast your contributions with a dynamic picture of your Profile

For maintainers:

• Score pull requests that participate in the Race of Sloths and receive a reward
• Engage contributors with fair scoring and fast responses so they keep their streaks
• Promote the Race to the point where the Race starts promoting you
• Grow the community of your contributors

Feel free to check our website for additional details!

Bot commands

• For contributors
  • Include a PR: @race-of-sloths include to enter the Race with your PR
• For maintainers:
  • Invite contributor @race-of-sloths invite to invite the contributor to participate in a race or include it, if it's already a runner.
  • Assign points: @race-of-sloths score [1/2/3/5/8/13] to award points based on your assessment.
  • Reject this PR: @race-of-sloths exclude to send this PR back to the drawing board.
  • Exclude repo: @race-of-sloths pause to stop bot activity in this repo until @race-of-sloths unpause command is called

[akorchyn]

I think it should be the full path to TreeMap but I'm not an expert in rustdoc...
(At least for me, it displays the warning)

warning: unresolved link to `TreeMap`
  --> near-sdk/src/store/mod.rs:55:9
   |
55 | //! - [`TreeMap`] (`unstable`): Storage version of [`std::collections::BTreeMap`]. Ordered ...

[dj8yfo]

this needs --features unstable suffix to cmd, otherwise it's referenced from doc, but not present in code.
probably that 's the reason....

also the behaviour slightly changes with toolchain version

❯ : rustdoc --version
rustdoc 1.83.0 (90b35a623 2024-11-26)

[akorchyn]

@race-of-sloths score 5