aboutsummaryrefslogtreecommitdiffstats
path: root/introduction/welcome/wiki.xml
blob: 1a020687c5d79ba093cb3b407c26ac61b66c7a37 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="wiki" xreflabel="wiki">
  <?dbhtml filename="wiki.html"?>


  <title>Editor Notes</title>

  <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>Due to excessive spamming, the commenting function is
        restricted to authenticated users (editors) only.</para>
      </listitem>
      <listitem>
        <para>Suggestions to change the book should be made by creating a new ticket,
        <emphasis>not</emphasis> by making comments in the Wiki.</para>
      </listitem>
      <listitem>
        <para>Questions with your specific installation problems should be made
        by subscribing and mailing to the BLFS Support Mailing List at <ulink
        url='mailto:blfs-support@&lfs-domainname;'/>.</para>
      </listitem>
      <listitem>
        <para>Discussions of build instructions should be made by subscribing
        and mailing to the BLFS Development List at <ulink
        url='mailto:blfs-dev@&lfs-domainname;'/>.</para>
      </listitem>
      <listitem>
        <para>Inappropriate material will be removed.</para>
      </listitem>
    </itemizedlist>

  </para>
-->

</sect1>