aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSwift Geek <swiftgeek@gmail.com>2017-06-06 11:41:41 +0000
committerGogs <gogitservice@gmail.com>2017-06-06 11:41:41 +0000
commit25c1952acd0bbf39630d956ed2404f4c896eb41b (patch)
tree03e8b662df0c634a0c1a40d4d56892c779c35de7
parentb598791cc7139094d7c76dbcbd45126d3a77f398 (diff)
parent6e4bd65054c463910a65a5cf8942225a351519e9 (diff)
downloadlibrebootfr-25c1952acd0bbf39630d956ed2404f4c896eb41b.tar.gz
librebootfr-25c1952acd0bbf39630d956ed2404f4c896eb41b.zip
Merge branch 'www/various-website-improvements' of libreboot/libreboot into master
-rw-r--r--www/contrib.md7
-rw-r--r--www/git.md30
2 files changed, 37 insertions, 0 deletions
diff --git a/www/contrib.md b/www/contrib.md
index b1089a39..2322157e 100644
--- a/www/contrib.md
+++ b/www/contrib.md
@@ -14,6 +14,13 @@ PHP. Additionally assisted with [booting
Linux](https://blog.rosenzweig.io/blobless-linux-on-the-pi.md) on the Raspberry
Pi without blobs. Current sysadmin and assists with project management.
+Andrew Robbins
+--------------
+
+Works on large parts of Libreboot's build system and related documentation.
+Andrew joined the Libreboot project as part of core management on 4 June 2017.
+IRC nick `and_who` on #libreboot IRC.
+
Arthur Heymans
--------------
diff --git a/www/git.md b/www/git.md
index f6ebab77..8c17ea54 100644
--- a/www/git.md
+++ b/www/git.md
@@ -33,6 +33,31 @@ We currently have a shortage of people who possess the skill to write and
maintain good documentation for Libreboot, so we welcome any and all
contributions!
+The .md files are written in Pandoc flavoured Markdown. The following scripts
+form Libreboot's *static site generator* which converts the Markdown files into
+HTML, to create the website:
+
+- index.sh: generates the news feed (on the News section of the website)
+- publish.sh: converts an .md file to an .html file
+- generate.sh: with calls to index.sh and publish.sh, compiles the entire
+ Libreboot website
+
+To view your local version of the website, it is advisable to install an HTTP
+server (e.g. nginx, lighttpd) and configure it so that the `www` directory in
+your local Git repository is the document root. With this, you can run
+`generate.sh` and view your own version of the website locally. This can be
+useful for larger changes (including structural) if you're making many large
+improvements to the website. However, it is possible to just edit the Markdown
+files with a text editor and submit those, or view individual .html files
+(generated by publish.sh) in a Web browser (e.g. Firefox).
+
+If you're running a local HTTP server, you can view your local version of the
+site by typing `localhost` into your browser's URL bar.
+
+At present, the site and documentation are optimized for use on the Web (as
+HTML, generated by Pandoc), but we would like to possibly support other use
+cases, such as PDF documents for printed manuals.
+
General guidelines for submitting patches
-----------------------------------------
@@ -48,6 +73,11 @@ the *Creative Commons Zero* license is highly recommended. Otherwise, the **GNU
General Public License, version 3 or (at your option) any later version**, is
preferred; we will also accept any other free license.
+*We require all documentation and website changes to use the [GNU Free
+Documentation License, version 1.3](docs/fdl-1.3.md) or (at your option) any
+later version published by the Free Software Foundation; without Invariant
+sections, without front cover texts and without back cover texts.*
+
Libreboot development is facilitated by *[git](https://git-scm.com/)*, a
*distributed* version control system. You will need to install Git (most
GNU+Linux distributions package it in their repositories).