borg2: wrong syntax in docs

[ThomasWaldmann]

borg2 does not use the repo::archive syntax anymore:

https://borgbackup.readthedocs.io/en/2.0.0b14/usage/general.html#logging

Do a global search for such errors in the docs (master branch).

[vancheese]

How can I help resolve this issue?

[ThomasWaldmann]

@vancheese thanks for helping!

You could do a global review of the docs (searching for stuff like repo::archive) and then submit a pull request with fixes on github.

The docs consist of:

• .rst[.inc] files in the docs/ folder.
• but be careful, some of these files have a comment in the first line telling that they are auto-generated. in that case the text comes from a .py source file usually.
• text strings extracted from .py source files, see src/borg/archiver/ folder

[vancheese]

Great, that looks like a great way to get started helping here
Any preferences re branching, naming etc as this first time helper, long-term user ?

[ThomasWaldmann]

As this refers to borg2 only, the fix is only needed in master branch.

We have some docs for (new) developers / contributors there:

https://borgbackup.readthedocs.io/en/stable/development.html

[vancheese]

What is the best way for asking for some help?

I'm working my way through the reported issue and just testing every command
I've moved to a local fork to prepare for a pull merge and I'm having issues with the version numbers as it appears the forking results in a version which is rejected by version.py module

Is there a way to override/define the version in the pyproject.toml so I can test the documentation etc using the latest git version?
I know this is overkill for a simple doc ticket , but I want to make sure everything works as expected

[ThomasWaldmann]

@vancheese see #8582 and please add the steps to reproduce there.

[vancheese]

@ThomasWaldmann - Christmas 2024 madnesss here - Not forgotten, will do soon :)