Document the replaceUsernames setting in .drone.star

[phil-davis]

This documents the replaceUsernames setting that can by used by developers or QA to run acceptance tests with different user names and user attributes.

Part of issue owncloud/core#33596

PR owncloud/core#38364 adds this CI functionality. This docs PR can be merged when that core PR is merged.

No backport - this is new CI functionality in core master.

[phil-davis]

The related PR has been merged. This PR is ready for review.

[mmattel]

Q: in the example, the content starts at the first line with a tab. Wouldnt it be good to reduce the indent of all lines by one tab making the result not so wide? Or is there an intention behind?

[phil-davis]

Q: in the example, the content starts at the first line with a tab. Wouldnt it be good to reduce the indent of all lines by one tab making the result not so wide? Or is there an intention behind?

I will adjust it. I did copy-paste of the example from .drone.star and that block was indented a lot.

[mmattel]

Just re-reading the text and one thing pops up, maybe I do not fully understanding it, but
Commit the changes to .drone.star and tests/acceptance/usernames.json, push to GitHub, and make a PR:
reads to my as an invite that everyone can now make a PR on GH overwriting the existing setup for a replaced username setting. Is this intended?
The settings below in the bash part may be fully correct, but there is no statement in which reference it stands for the text above.

[phil-davis]

reads to my as an invite that everyone can now make a PR on GH overwriting the existing setup for a replaced username setting. Is this intended?

I had better write more words! This is for running a test to see if some weird combinations username, display name, email address... break anything. The PR just makes CI run to get a result. It is not intended to be merged. Someone could try to run the whole test suite locally on their machine at home, but it would take all day. With a "demonstration" PR they can test some combination that might be suspected of having a problem.

The challenge is how to write useful words, but not write a whole essay like in the paragraph above.

[phil-davis]

I wrote more words - @mmattel comments?