document persistent major version feature

[mrow4a]

References:
owncloud/core#40531 (Implement persistent major version workflow (v2))
owncloud/core#40636 ([docs-only] Fix headline in config.sample)

Document the persistent major version feature.

Needs a config-to-docs run (see commit config-to-docs run).

No Backport

[mmattel]

@mrow4a the change in config_sample_php_parameters.adoc needs to be removed and instead added to core. You can do that in the open PR in core. I will then do a config-to-docs run which transports the changes to docs.

[jvillafanez]

I'd change the image. The first time I saw it I thought the "publish version" below the check mark was a button, not a tooltip, so I was surprised when I didn't see the button.
I don't know how we can make it clear that it's a tooltip, so I think it's better to remove from the image. Just take the same screenshot without the tooltip showing, and maybe use a bit more realistic usernames

[mrow4a]

@mrow4a the change in config_sample_php_parameters.adoc needs to be removed and instead added to core. You can do that in the open PR in core. I will then do a config-to-docs run which transports the changes to docs.

@mmattel I am afraid I do not understand.

[mrow4a]

@mmattel what you mean is https://github.com/owncloud/core/blob/81e3c8b7e741d708f984b6c500eaadbe1dce348a/config/config.sample.php#L717-L723 ? It is already done? So it will be automatically done in config_sample_php_parameters.adoc ?

[mmattel]

just not in front of my nb, but any changes related to config sample must be made in core. if they already exist, fine. if in this pr, fine. if not, must be added.
any changes manually added in docs, will be automatically removed on the next config-to-docs run.
a config-to-docs run will then transport any changes made to docs which I will do. for details see the config to docs repo.

[mrow4a]

@jvillafanez adjusted to content review

[mmattel]

I have made a config-to-docs run and fixed the link and text and image size.
Waiting for 40636 in core to be merged.

[mmattel]

no changes in config sample pls.
content comes from core...

[mmattel]

Note, beside the comment from phil-davis above, all is fixed and a language review made. The current build is visible on staging. @mrow4a pls take a look on that comment and respond or fix. Technically we could merge after that.

[mrow4a]

as mentioned in #840 (comment) , newly added text is wrong

[mmattel]

as mentioned in #840 (comment) , newly added text is wrong

fixed and rebased, ready to merge

[mrow4a]

your call, I just made doc update suggestion 😉