resticprofile icon indicating copy to clipboard operation
resticprofile copied to clipboard

Update to Documentation!

Open Inventhrice opened this issue 1 month ago β€’ 8 comments

This is the work I've done so far for the documentation! Let me know your thoughts :)

Inventhrice avatar Nov 17 '25 01:11 Inventhrice

[!IMPORTANT]

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches
πŸ§ͺ Generate unit tests (beta)
  • [ ] Create PR with unit tests
  • [ ] Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❀️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

coderabbitai[bot] avatar Nov 17 '25 01:11 coderabbitai[bot]

Codecov Report

:white_check_mark: All modified and coverable lines are covered by tests. :white_check_mark: Project coverage is 81.00%. Comparing base (bce38f0) to head (cf92423). :warning: Report is 3 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #579      +/-   ##
==========================================
+ Coverage   79.69%   81.00%   +1.31%     
==========================================
  Files         137      137              
  Lines       13467    11083    -2384     
==========================================
- Hits        10732     8977    -1755     
+ Misses       2310     1680     -630     
- Partials      425      426       +1     
Flag Coverage Ξ”
unittests 81.00% <ΓΈ> (+1.31%) :arrow_up:

Flags with carried forward coverage won't be shown. Click here to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

:rocket: New features to boost your workflow:
  • :snowflake: Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

codecov[bot] avatar Nov 18 '25 21:11 codecov[bot]

I'll have a look at it during the week or at the week-end, thank you for your help πŸ‘πŸ»

creativeprojects avatar Nov 18 '25 21:11 creativeprojects

Just wanted to bump this to bring to your attention! Lemme know if the direction this is heading at is looking good!

Inventhrice avatar Dec 01 '25 05:12 Inventhrice

Hi!

I finally got a bit of time to look at it. I can see the reorganisation of the chapters makes sense to me, that's nice, thank you πŸ‘πŸ»

Sadly I can't try to view the result locally, I get an error on building it with Hugo:

ERROR [en] REF_NOT_FOUND: Ref "/reference/jsonschema": "/go/src/github.com/creativeprojects/resticprofile/docs/content/configuration/profiles/editorConfig.md:7:64": page not found

Are you using a different version of Hugo by any chance?

creativeprojects avatar Dec 02 '25 22:12 creativeprojects

Ah! I see what's happened. To explain:

  1. "/reference/jsonschema" wasn't found in /docs/content/configuration/profiles/editorConfig.md:7:64
  2. Checking my repo, /docs/content/reference is empty

This is different than my working version, which has the following under the same dir: image

I've pushed a change that just updates the link, it should be good!

Inventhrice avatar Dec 03 '25 03:12 Inventhrice

Cool I can browse the doc locally, it's easier to see that way πŸ‘πŸ» I'm not too sure why the pipeline is failing: it works when I run the script to check all the links locally (via make checklinks)

creativeprojects avatar Dec 03 '25 22:12 creativeprojects

Build looks to be failing at the check broken links, which makes sense/is to be expected (seeing as the update to the docs would move a lot of the links around)

Inventhrice avatar Dec 03 '25 22:12 Inventhrice