Changeset 812f47a for introduction/welcome/askhelp.xml

Timestamp:

10/02/2024 05:58:40 PM (6 days ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

trunk

Children:

db57c3e

Parents:

1f568d14

git-author:

Xi Ruoyao <xry111@…> (10/02/2024 05:53:28 PM)

git-committer:

Xi Ruoyao <xry111@…> (10/02/2024 05:58:40 PM)

Message:

askhelp: Discourage and encourage scripting

The subject seems irony. We should clearly say scripting is deviating
from the book because there are too many cases where people fail to
notice a subtle difference between the script and the book. But if you
must deviate anyway (no matter scripting or not), it's better to have a
script to tell precisely what the deviation is.

I still believe scripting does not make too much sense for building
BLFS, but having the script is at least better than guessing what the
script contains.

File:

• introduction/welcome/askhelp.xml (modified) (2 diffs)

introduction/welcome/askhelp.xml

@@ -77 +77 @@
       </listitem>
       <listitem>
-        <para>whether you have deviated from the book or LFS at all,</para>
+        <para>whether you have deviated from the book or LFS at all
+        (packing the book instructions into a script while the book does not
+        tell to do so is always considered as deviation, because there have
+        been too many cases of issues where people fail to notice a subtle
+        difference between the script and the book),</para>
       </listitem>
       <listitem>
@@ -84 +88 @@
     </itemizedlist>
 
-    <para>(Note that saying that you've deviated from the book doesn't mean
+    <para>Note that saying that you've deviated from the book doesn't mean
     that we won't help you. It'll just help us to see other possible causes
-    of your problem.)</para>
+    of your problem. If you've deviated from the book, you should also tell
+    precisely what the deviation is so the other people can reproduce it.
+    A script can be attached to show what you've exactly done (especially
+    if you already have such a script, i.e. you've already have deviated
+    from the book by packing the book instructions into a script and run
+    it).</para>
 
     <para>Expect guidance instead of specific instructions. If you are