we've been assimilated

1 files changed, 76 insertions, 5 deletions

diff --git a/site/download/index.php b/site/download/index.php
index 3c4b5e0..d2b854f 100644
--- a/site/download/index.php
+++ b/site/download/index.php
@@ -110,11 +110,6 @@
     				also includes links to the Git repositories. This shows how to submit patches.
     			</p>
                 <p>
-                    Get in GNU. See <a href="../gnu/">../gnu/</a>. PaulK is working on the build system changes,
-                    we still need to finish transitioning over to Texinfo for the documentation.
-                    <strong>Becoming part of GNU is a #1 priority for the libreboot project.</strong>
-                </p>
-                <p>
                     D16 and D8 doesn't boot with GRUB payload, see
                     <a href="https://ticket.coreboot.org/issues/48">https://ticket.coreboot.org/issues/48</a>
                     - workaround: seabios as main payload, compress grub and put that in cbfs too, configure
@@ -166,6 +161,82 @@
                     found in the <a href="../contrib/">contrib</a> page.
                     This could take months though, so probably won't be done before the next release.
                 </p>
+				<ul class="c">
+					<li>
+						Convert the documentation to texinfo - partially complete. The docs have been converted using pandoc, 
+						but now require a serious cleanup.
+						We wish to merge these into 1 documentation file (manual) in texinfo file. 
+						The <a href="https://www.gnu.org/software/texinfo/manual/texinfo/">texinfo manual</a> itself
+						is an example of how we would like to implement the new libreboot documentation. One file, but we 
+						will distribute it separated into separate pages/sections, 
+						and in other formats in addition to HTML. (info, PDF, etc). The current live documentation on the 
+						libreboot website is the old pre-conversion documentation,
+						written in raw HTML. To encourage the transition, we are now refusing all new documentation submissions 
+						that are not in texinfo format.
+						<ul>
+							<li>Texinfo is the official documentation format, for all GNU software.</li>
+							<li>GNU Emacs has decent integration for editing Texinfo documents. See <em>Texinfo mode</em>.
+							However, any text editor should be fine (the lead developer of libreboot uses Vim).</li>
+							<li>
+								i18n should be implemented from the start, so that we can start maintaining versions of the documentation
+								in non-English languages. GNU Gettext can be used for this.
+							</li>
+						</ul>
+					</li>
+					<li>
+						Modify the build system, to make use of standard GNU utilities: make, autoconf and so on. The current build system is 
+						non-standard (but well documented), written mostly in BASH.Read these documents:
+						<ul>
+							<li><a href="https://www.gnu.org/prep/standards/html_node/Standard-Targets.html">https://www.gnu.org/prep/standards/html_node/Standard-Targets.html</a></li>
+							<li><a href="https://www.gnu.org/prep/maintain/maintain.html#Distributions">https://www.gnu.org/prep/maintain/maintain.html#Distributions</a></li>
+						</ul>
+					</li>
+					<li>
+                                        Modify the build system, to
+					directly download the
+					build dependencies
+					that libreboot
+					currently tells the
+					user to install from
+					their distribution
+					package repository.
+					(Only in Git. Release
+					archives would have
+					them already). Build
+					these from source,
+					with our own GCC
+					(re-using coreboot's
+					GCC, which libreboot
+					already uses). This
+					will make <em>complete
+					corresponding
+					source</em> provision
+					easier, because it
+					would be automated;
+					this is in contrast to
+					the present setup,
+					where the person
+					distributing binaries
+					has to include the
+					sources for build
+					dependencies from the
+					distribution that they
+					happened to use for
+					compiling those
+					packages.
+                                                
+						<ul>
+							<li>This will also make everything self-contained, and coreboot already has integration for cross-compiling. We can make cross compilation
+							of utilities for non-x86 architectures much easier, without relying on quirks from the user's GNU/Linux distribution, where the
+							only thing we need from their distribution is the necessary toolchain for building <em>libreboot's own version of GCC</em>, which would then take over</li>
+							<li>
+								However, do not install these dependencies, only self-host them in the libreboot source archive. Also provide an option for the user to ignore libreboot's
+								GCC and dependencies, and use what their GNU/Linux distribution provides, when building from source.
+							</li>
+						</ul>
+					</li>
+				</ul>
+
 	</div>
 
 <?php