various updates

Signed-off-by: John Crispin <john@phrozen.org>

diff --git a/docs/config.txt b/docs/config.txt
new file mode 100644 (file)
index 0000000..10d0ab0
--- /dev/null
+++ b/docs/config.txt
@@ -0,0 +1,12 @@
+UCI files
+=========
+
+* link:uci_dnsmasq.html[/etc/config/dhcp]
+* link:uci_dropbear.html[/etc/config/dropbear]
+* link:uci_firewall.html[/etc/config/firewall]
+* link:uci_fstab.html[/etc/config/fstab]
+* link:uci_net.html[/etc/config/network]
+* link:uci_qos.html[/etc/config/qos]
+* link:uci_samba.html[/etc/config/samba]
+* link:uci_system.html[/etc/config/system]
+* link:uci_wireless.html[/etc/config/wireless]

diff --git a/docs/menu.inc b/docs/menu.inc
index 2162b7034366891369d7bd37802363e8a479591d..864d9ffc65024d2cb8d8aa4969f252c72257b4f6 100644 (file)
--- a/docs/menu.inc
+++ b/docs/menu.inc
@@ -1,6 +1,7 @@
 [role="menu"]
 . link:../index.html[← Home]
 . pass:attributes[<a href="index.html" class="{docname@index:active}">Index</a>]
-. pass:attributes[<a href="uci.html" class="{docname@uci:active}">Configuration</a>]
+. pass:attributes[<a href="uci.html" class="{docname@uci:active}">UCI</a>]
+. pass:attributes[<a href="config.html" class="{docname@uci:active}">Configuration</a>]
 . pass:attributes[<a href="ubus.html" class="{docname@ubus:active}">uBus</a>]
 . pass:attributes[<a href="procd.html" class="{docname@procd:active}">Procd</a>]

diff --git a/docs/procd.txt b/docs/procd.txt
new file mode 100644 (file)
index 0000000..0473a32
--- /dev/null
+++ b/docs/procd.txt
@@ -0,0 +1,19 @@
+The Procd System Manager
+========================
+
+include::menu.inc[]
+
+== Procd
+
+_LEDE_ uses 'procd' for booting the system, managing processes and handling parts of the kernel/userland interaction. It can be considered similar to 'systemd' on full blown distributions. Here is a list of tasks that procd will do for us
+
+* provide the pid 1 init service / preinit
+* wathchdog
+* inittab
+* init.d
+* hotplug
+* service startup / monitoring
+* (configuration-)triggers
+
+*WIP*
+

diff --git a/docs/uci.txt b/docs/uci.txt
index 0ec5cde5d7577067e2063a161d190f269ba0ca7e..423daeb06c9fa153fa70fc0b7bef37fa182c9f08 100644 (file)
--- a/docs/uci.txt
+++ b/docs/uci.txt
@@ -45,14 +45,4 @@ root@lede:/#
 root@foo:/#
 ----
 
-=== UCI files
-
-* link:uci_dnsmasq.html[/etc/config/dhcp]
-* link:uci_dropbear.html[/etc/config/dropbear]
-* link:uci_firewall.html[/etc/config/firewall]
-* link:uci_fstab.html[/etc/config/fstab]
-* link:uci_net.html[/etc/config/network]
-* link:uci_qos.html[/etc/config/qos]
-* link:uci_samba.html[/etc/config/samba]
-* link:uci_system.html[/etc/config/system]
-* link:uci_wireless.html[/etc/config/wireless]
+

diff --git a/pages/about.txt b/pages/about.txt
new file mode 100644 (file)
index 0000000..d5d3760
--- /dev/null
+++ b/pages/about.txt
@@ -0,0 +1,18 @@
+About the LEDE project
+======================
+
+include::menu.inc[]
+
+== Name
+
+image:logo/logo.png["The LEDE logo",role="left"]
+The name _LEDE_ is an abbreviation for Linux Embedded Development Environment,
+a reference to its flexibility and embedded buildroot origins, making it a
+solid choice for embedded Linux applications far beyond the wireless router
+and network appliance realm.
+
+_LEDE_ is also an alternation of the phrase _to lead_, describing
+an introductory section of a news story that is intended to entice the reader
+to read the full story.
+
+

diff --git a/pages/development.txt b/pages/development.txt
index b178f49426a3fa23cc81b89892d3ed8b196923c1..726de8964910318650ae8459b858cf1a87ebdba5 100644 (file)
--- a/pages/development.txt
+++ b/pages/development.txt
@@ -57,7 +57,7 @@ also be submitted via the
 http://lists.infradead.org/mailman/listinfo/lede-dev[development mailing list].
 Submissions should follow these rules
 
-. rule N+1
+. TBD
 
 All patches need to be sent in a format that they are listed in patchwork (__LINK__).
 If the patch does not get listed in patchwork then it wont get processed.

diff --git a/pages/index.txt b/pages/index.txt
index c7d49581b632fcad43c9739ff378dd3ee59aba2e..4f0eea34cc269e41692ac764da91e7d66dd9b938 100644 (file)
--- a/pages/index.txt
+++ b/pages/index.txt
@@ -3,18 +3,33 @@ Welcome to the LEDE project
 
 include::menu.inc[]
 
-== About
-
-The LEDE project was founded in April 2016 as an OpenWrt based spin off with a
-strong focus on transparency, user collaboration and decentralised structures.
-
-For a long time the OpenWrt parent project experienced infrastructure issues
-and declining developer participation on the base system while the community
-driven package ecosystem around it continued to thrive. When the number of
-frequently active committers reached a new low in the beginning of 2016, some
-OpenWrt developers decided to start a new spin-off project in an attempt to
-change the development processes from the ground up and reboot the project in
-a new, community-driven way.
+== Introducing the LEDE project - A reboot of the OpenWrt community
+
+The LEDE project is founded as a spin-off of the OpenWrt project and shares many of the same goals.
+We are building an embedded Linux distribution that makes it easy for developers, system administrators or other Linux enthusiasts to build and customize software for embedded devices, especially wireless routers.
+The name 'LEDE' stands for 'Linux Embedded Development Environment'.
+
+Members of the project already include a significant share of the most active members of the OpenWrt community.
+We intend to bring new life to Embedded Linux development by creating a community with a strong focus on transparency, collaboration and decentralisation.
+
+LEDE’s stated goals are:
+- Building a great embedded Linux distribution with focus on stability and functionality.
+- Having regular, predictable release cycles coupled with community provided device testing feedback.
+- Establishing transparent decision processes with broad community participation and public meetings.
+
+We decided to create this new project because of long standing issues that we were unable to fix from within the OpenWrt project/community:
+1. Number of active core developers at an all time low, no process for getting more new people involved.
+2. Unreliable infrastructure, fixes prevented by internal disagreements and single points of failure.
+3. Lack of communication, transparency and coordination in the OpenWrt project, both inside the core team and between the core team and the rest of the community.
+4. Not enough people with commit access to handle the incoming flow of patches, too little attention to testing and regular builds.
+5. Lack of focus on stability and documentation.
+
+To address these issues we set up the LEDE project in a different way compared to OpenWrt:
+1. All our communication channels are public, some read-only to non-members to maintain a good signal-to-noise ratio.
+2. Our decision making process is more open, with an approximate 50/50 mix of developers and power users with voting rights.
+3. Our infrastructure is simplified a lot, to ensure that it creates less maintenance work for us.
+4. We have made our merge policy more liberal, based on our experience with the OpenWrt package github feed.
+5. We have a strong focus on automated testing combined with a simplified release process.
 
 === Goals
 
@@ -27,22 +42,10 @@ LEDE's stated goals are:
 . Establishing transparent decision processes with broad community
   participation and public meetings.
 
-=== Name
-
-image:logo/logo.png["The LEDE logo",role="left"]
-The name _LEDE_ is an abbreviation for Linux Embedded Development Environment,
-a reference to its flexibility and embedded buildroot origins, making it a
-solid choice for embedded Linux applications far beyond the wireless router
-and network appliance realm.
-
-_LEDE_ is also an alternation of the phrase _to lead_, describing
-an introductory section of a news story that is intended to entice the reader
-to read the full story.
-
 === Endorsement
 
 The *Wrt community is made up of many great communities all tinkering on their
-own mission in improving something on this planet. the Following communities have
-kindly decided to endorse our project. Thanks !
+own mission in improving something on this planet. The Following communities have
+kindly decided to endorse this project. Thanks !
 
 . none so far :-)

diff --git a/pages/menu.inc b/pages/menu.inc
index 158630e80f04f74d0a076752c0b4003f50fe8c55..ef0e39f1c8509ec764bfb98595b35d5ff2484073 100644 (file)
--- a/pages/menu.inc
+++ b/pages/menu.inc
@@ -1,8 +1,9 @@
 [role="menu"]
-. pass:attributes[<a href="index.html" class="{docname@index:active}">About</a>]
+. pass:attributes[<a href="index.html" class="{docname@index:active}">Home</a>]
 . pass:attributes[<a href="communication.html" class="{docname@communication:active}">Communication</a>]
 . pass:attributes[<a href="rules.html" class="{docname@rules:active}">Rules</a>]
 . pass:attributes[<a href="development.html" class="{docname@development:active}">Development</a>]
 . pass:attributes[<a href="todo.html" class="{docname@todo:active}">Todo</a>]
 . pass:attributes[<a href="meetings.html" class="{docname@meetings:active}">Meetings</a>]
 . pass:attributes[<a href="docs/index.html">Documentation</a>]
+. pass:attributes[<a href="about.html" class="{docname@index:active}">About</a>]