Allow admin to blacklist groups for the files_sharing app

[mmattel]

Core:
owncloud/core#31672 (Allow admin to blacklist groups for the files_sharing app)
--> merged
owncloud/core#31740 ([stable10] Sharing blacklist groups stable10)
--> open

It is something that is shown on the settings panel
(apps/files_sharing/lib/Panels/Admin/SettingsPanel.php)
and
(apps/files_sharing/templates/settings.php)

Quote:

These groups will not receive shares. 
Members of the group can still send and receive shares outside of the group

This new info should be described in the panel documentation.

[mmattel]

core PR got merged, documentation needs to be created !

[voroyam]

documentation needs to be created !

You are welcome to create it :)

Read the PR - no info how to use it.

My question is as always - what needs to be documented?

Link to PR is not sufficient @jvillafanez

[mmattel]

The waiting for PR label was accidentially removed, stable10 is still open

[jvillafanez]

Read the PR - no info how to use it.

I'd prefer not to provide information unless the feature needs it. I usually include some information if the behaviour might be confusing or if there are some problematic scenarios, but this isn't the case.

The feature should be easy to use. If you have doubts, feel free to ask: we'll likely need to add documentation for that.

My question is as always - what needs to be documented?

At least basic stuff: that the feature is there, how you can configure it, what is expected to happen... other than that, play with it and check if there is anything that might need to clarify.

These groups will not receive shares.
Members of the group can still send and receive shares outside of the group

Is this clear enough, or do we need to provide an example in the docs?

[mmattel]

Any example that helps making the use more clear is always a good thing.

[micbar]

Does that help?
We need to document this.

Real Use Case

1. You are using the guest app
2. You don't want users to share something with the guest group (which are usually external users)
3. Add guest_app to the sharing blacklist
4. Sharing to the guest_app group will not be possible, while sharing to other groups and Users, even if they are members of the blacklisted group will continue to be possible.

[voroyam]

@mic thanks. This helps.

@jvillafanez @mmattel this is the documentation repo, not the "here, we have something new. You figure out how to deal with it and document it while you are doing it"- repo.

Putting a little effort in describing your new feature that you want / you need to be documented goes a long way.

[voroyam]

https://doc.owncloud.com/server/admin_manual/configuration/files/file_sharing_configuration.html#blacklist-groups-from-receiving-shares

already implemented