New issue
Advanced search Search tips

Issue 872317 link

Starred by 2 users

Issue metadata

Status: WontFix
Owner:
Closed: Sep 10
Cc:
Components:
EstimatedDays: ----
NextAction: ----
OS: Linux , Android , Windows , iOS , Chrome , Mac , Fuchsia
Pri: 3
Type: Bug



Sign in to add a comment

Don't generate policy examples for unsupported platforms

Project Member Reported by bartfab@chromium.org, Aug 8

Issue description

We specify in policy_templates.json what platforms a given policy is supported on. When generating policy documentation (https://www.chromium.org/administrators/policy-list-3), this information is ignored and examples for all platforms are generated.

This is confusing users/admins. They see an example for their platform and assume this must mean the policy will work for them.

We should only generate example values for platforms that are actually supported.
 
Labels: Enterprise-Policy
Can this be modified to include options within policies that don't work on certain platforms? For example, IT admins see "Forced" as an option for "IncognitoModeAvailability", but that isn't implemented for Android - only "blocked" and "available" work. This was reported in this bug: https://bugs.chromium.org/p/chromium/issues/detail?id=818872

Thanks.
Cc: ljusten@chromium.org
Whoever wants to take this bug can go as wild as they want... right now, our example generation is extremely simplistic.

+Lutz as he has an interest in unusual policy types (e.g. GPO for Chromebooks).
The html doc writer does check supported platforms and I can't find a case where it's spitting out a wrong example.

Do you have an example where it's not behaving right?

Here's the code:
https://cs.chromium.org/chromium/src/components/policy/tools/template_writers/writers/doc_writer.py?q=doc_writer.py&sq=package:chromium&dr&l=265

Re: Can this be modified to include options within policies that don't work on certain platforms?

There's no general concept for "some settings don't work on some platform" in the policy code and it would be too troublesome to add this (basically, every property would need a 'supported_on' field). I'd recommend explaining this in the description, e.g. "Note that 'Forced' does not work on Android platforms".
Labels: Enterprise-Triaged
Owner: georgesak@chromium.org
Assigning to georgesak@ for prioritization and triage.
Status: WontFix (was: Available)
Took another look, this doesn't look it's the case, examples seem to reflect the supported platforms.

Closing this as Wont Fix. Reopen with an example if it's no the case.

Sign in to add a comment