summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--documentation.mdwn51
1 files changed, 50 insertions, 1 deletions
diff --git a/documentation.mdwn b/documentation.mdwn
index 5c666f3f..5ab08bfb 100644
--- a/documentation.mdwn
+++ b/documentation.mdwn
@@ -1,4 +1,5 @@
-[[!meta copyright="Copyright © 2008, 2010 Free Software Foundation, Inc."]]
+[[!meta copyright="Copyright © 2008, 2010, 2011 Free Software Foundation,
+Inc."]]
[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
@@ -8,8 +9,56 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]
+You are interested in getting familiar with the GNU/Hurd system architecture,
+or specific components of it? Here is a collection of texts to read.
+
+/!\ A lot of stuff is still missing ([[!taglink open_issue_documentation]]).
+
+[[!toc levels=3]]
+
+
+# Basic Knowledge
+
+Before you can go details, you have to learn the basics about operating system
+architecture. Yes, really.
+
+
+## Operating Systems Basics
+
+Books. Etc.
+
+
+## GNU/Hurd System Architecture
+
+
+### Capabilities
+
+[[!toggleable id=shapiro_capintro_1999 text="""[[!template id=note
+text="*[[shapiro\_capintro\_1999|capability]]*:
+{{$capability#shapiro_capintro_1999}}.
+{{$capability#shapiro_capintro_1999_text}}."]]"""]]
+
+ * Our use of [[capabilities|capability]]. The
+ {{$capability#wikipedia_capability-based_security}} article.
+ Alternatively/additionally, [[!toggle id=shapiro_capintro_1999
+ text="[shapiro\_capintro\_1999]"]].
+
+ In the GNU/Hurd system, a [[capability]] is represented by a [[Mach
+ port|microkernel/mach/port]].
+
+ * {{$capability#wikipedia_object-capability_model}}. Albeit not directly
+ tailored at the GNU/Hurd operating system architecture, this artice anyway
+ does a good job at describing general principles of a [[capability]]-based
+ system architecture.
+
+
+# FAQ
+
[[FAQ]]
+
+# Specific Components
+
Documentation for...
* [[GNU_Hurd|hurd/documentation]]