Index: doc/en_US.ISO8859-1/articles/committers-guide/article.xml
===================================================================
--- doc/en_US.ISO8859-1/articles/committers-guide/article.xml
+++ doc/en_US.ISO8859-1/articles/committers-guide/article.xml
@@ -340,8 +340,9 @@
       </listitem>
     </itemizedlist>
 
-    <para>To reset a Kerberos password in the &os; cluster using a
-      random password generator:</para>
+    <para>To create a new Kerberos account in the &os; cluster or to reset
+      a Kerberos password for an existing account using a random password
+      generator:</para>
 
     <screen>&prompt.user; <userinput>ssh kpasswd.freebsd.org</userinput></screen>
 
@@ -356,6 +357,16 @@
       running:</para>
 
     <screen>&prompt.user; <userinput>kpasswd</userinput></screen>
+
+    <note>
+      <para>This method will fail with the
+        <errorname>Client unknown</errorname> error if you never used the
+        Kerberos-authenticated service(s) of the &os;.org cluster before.
+        Don't panic, you just need to go through the
+        <userinput>ssh kpasswd.freebsd.org</userinput> method above first
+        to get your Kerberos account properly initialized.</para>
+    </note>
+
   </sect1>
 
   <sect1 xml:id="committer.types">