Changeset 4d19786

Timestamp:

06/29/2023 06:19:19 AM (12 months ago)

Author:

Thomas Trepl <thomas@…>

Branches:

12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

a1bb0d9

Parents:

76f2fb4

Message:

Change 'User notes' to 'Editor notes'

File:

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

introduction/welcome/wiki.xml

@@ -10 +10 @@
 
 
-  <title>BLFS Wiki</title>
+  <title>Editor Notes</title>
 
-  <para>The BLFS Project has created a Wiki for users to comment on pages
-  and instructions at <ulink url='&blfs-wiki;'/>.
-  Comments are welcome from all users.</para>
+  <para>The BLFS Project has created a Wiki for editors to comment
+  on pages and instructions at <ulink url='&blfs-wiki;'/>.</para>
 
+  <para>When <emphasis>editor notes</emphasis> are present, a link 
+  appears in the form <literal>&blfs-wiki;/pkgname</literal> right
+  below the dependency list. The idea behind the editor notes is to
+  give additional information about the package and/or its build
+  instructions, common pitfalls or maybe even more sophisticated
+  configuration for special cases of use.</para>
+
+  <para>The vast majority of the packages do not have editor notes.</para>
+  
+  <note>
+    <para>
+      The <emphasis>editor notes</emphasis> might be outdated. Even 
+      though the pages should be reviewed when a package is updated,
+      it might happen that there are notes referring to an obsolete
+      version and therefore, the notes might be out of date. Always
+      check the date of the notes and more importantly, the version
+      of the package the notes refer to.
+    </para>
+  </note>
+
+<!--
   <para>The following are the rules for posting:
 
     <itemizedlist>
       <listitem>
-        <para>Users must register and log in to edit a page.</para>
+        <para>Due to excessive spamming, the commenting function is
+        restricted to authenticated users (editors) only.</para>
       </listitem>
       <listitem>
@@ -42 +63 @@
 
   </para>
+-->
 
 </sect1>