Non-cubic cube described in policy-language.md

[rbanffy]

Short description

In /docs/content/policy-language.md, (https://www.openpolicyagent.org/docs/latest/policy-language/#sets) the cube described is a very weird one. One would assume that little bit of surreal (a 3x4x5 "cube") is done on purpose. Should it be fixed?

Steps To Reproduce

1. Open https://www.openpolicyagent.org/docs/latest/policy-language/#sets
2. Picture a 3x4x5 cube

Expected behavior

It should be cubic.

Additional context

https://en.wikipedia.org/wiki/Cube

[srenatus]

Good point! Let's use a word that describes the thing better. It's not a cube. I guess it would make sense to compare two sets, like, a cube's edge lengths would be a one-element set, whereas another three-dimensional body (rectangular cuboid) would have an edge-length-set of more than one element... Or let's go with fruit or something. 😄

[rbanffy]

I thought about brick, but rectangular_cuboid sounds much more precise. I'll try to find the documentation on how to actually run the documentation, as it seems it's evaluated when rendered to HTML (and that changes what I'd need to write).

[stale[bot]]

This issue has been automatically marked as inactive because it has not had any activity in the last 30 days. Although currently inactive, the issue could still be considered and actively worked on in the future. More details about the use-case this issue attempts to address, the value provided by completing it or possible solutions to resolve it would help to prioritize the issue.