more comments to HOWTO from Randy

1 files changed, 18 insertions, 5 deletions

diff --git a/HOWTO b/HOWTO
index beb2357c23cc1..b24ea4a958c1a 100644
--- a/HOWTO
+++ b/HOWTO
@@ -65,9 +65,11 @@ Documentation
 ------------
 
 The Linux kernel source tree has a large range of documents that are
-invaluable in learning how to interact with the kernel community.  Here
-is a list of files that are in the kernel source tree that are required
-reading:
+invaluable in learning how to interact with the kernel community.  When
+new features are added to the kernel, it is recommended that new
+documentation files are also added, that explain how to use the feature.
+Here is a list of files that are in the kernel source tree that are
+required reading:
   Documetation/CodingStyle
     This describes the Linux kernel coding style, and some of the
     rationale behind it.  The main point here is that we have a coding
@@ -325,8 +327,19 @@ not ready for inclusion now.
 Also realize that it is not acceptable to send patches for inclusion
 that are unfinished and will be "fixed up later."
 
-These things are sometimes very hard to do. It can take years
-to perfect these practices (if at all). It's a continuous process of
+
+Justify your change
+-------------------
+
+Along with breaking up your patches, it is very important for you to let
+the Linux community know why they should add this change.  New features
+must be justified as being needed and useful.
+
+
+
+
+All of these things are sometimes very hard to do. It can take years to
+perfect these practices (if at all). It's a continuous process of
 improvement that requires a lot of patience and determination. But,
 don't give up. It's possible. Many have done it before, and each had to
 start exactly where you are now.