aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.rst
diff options
context:
space:
mode:
Diffstat (limited to 'CONTRIBUTING.rst')
-rw-r--r--CONTRIBUTING.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 160f86c..f9a888d 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -66,6 +66,13 @@ Code style
- Choose judiciously between a functional programming style and LOOP. Err on
the side of LOOP.
+- Avoid complicating property definitions to include updates to file
+ ownership, and the like, when it's possible instead to switch to the target
+ user and apply a simpler version of the property. For example, instead of
+ taking a username as a parameter and then changing the ownership of any
+ newly created files to the named user, you can use the ``AS`` combinator to
+ apply the property as that user in the first place.
+
Signing off your commits
========================