From 8c4d6dc327fd12c5aeb84e5d82ce705a48039a47 Mon Sep 17 00:00:00 2001 From: John Crispin Date: Fri, 29 Apr 2016 13:46:00 +0200 Subject: [PATCH] various updates Signed-off-by: John Crispin --- docs/config.txt | 12 ++++++++++ docs/menu.inc | 3 ++- docs/procd.txt | 19 +++++++++++++++ docs/uci.txt | 12 +--------- pages/about.txt | 18 ++++++++++++++ pages/development.txt | 2 +- pages/index.txt | 55 +++++++++++++++++++++++-------------------- pages/menu.inc | 3 ++- 8 files changed, 84 insertions(+), 40 deletions(-) create mode 100644 docs/config.txt create mode 100644 docs/procd.txt create mode 100644 pages/about.txt diff --git a/docs/config.txt b/docs/config.txt new file mode 100644 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 2162b70..864d9ff 100644 --- a/docs/menu.inc +++ b/docs/menu.inc @@ -1,6 +1,7 @@ [role="menu"] . link:../index.html[← Home] . pass:attributes[Index] -. pass:attributes[Configuration] +. pass:attributes[UCI] +. pass:attributes[Configuration] . pass:attributes[uBus] . pass:attributes[Procd] diff --git a/docs/procd.txt b/docs/procd.txt new file mode 100644 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 0ec5cde..423daeb 100644 --- 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 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 b178f49..726de89 100644 --- 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 c7d4958..4f0eea3 100644 --- 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 158630e..ef0e39f 100644 --- a/pages/menu.inc +++ b/pages/menu.inc @@ -1,8 +1,9 @@ [role="menu"] -. pass:attributes[About] +. pass:attributes[Home] . pass:attributes[Communication] . pass:attributes[Rules] . pass:attributes[Development] . pass:attributes[Todo] . pass:attributes[Meetings] . pass:attributes[Documentation] +. pass:attributes[About] -- 2.30.2