diff --git a/doc/coding-conventions.xml b/doc/coding-conventions.xml
index 61d373738f90..04adcdea1cb2 100644
--- a/doc/coding-conventions.xml
+++ b/doc/coding-conventions.xml
@@ -256,6 +256,12 @@ bound to the variable name e2fsprogs in
a package named hello-svn by
nix-env.
+ If package is fetched from git's commit then
+ the version part of the name must be the date of that
+ (fetched) commit. The date must be in "YYYY-MM-DD" format.
+ Also add "git" to the name - e.g.,
+ "pkgname-git-2014-09-23".
+
Dashes in the package name should be preserved
in new variable names, rather than converted to underscores
(which was convention up to around 2013 and most names