Add initial documentation for Layout API, not everything is documented, and it's not perfect, but its time to commit this.

git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@39055 a95241bf-73f2-0310-859d-f6bbb57e9c96

docs/user/interface/_interface_intro.dox

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2010, Haiku, Inc. All Rights Reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Documentation by:
+ *		Alex Wilson <[email protected]>
+ */
+
+
+/*!
+	\page interface_intro Introduction to the Interface Kit.
+  
+	The Interface Kit holds all the classes you'll need to develop a GUI.
+	Building on the messaging facilities provided by the Application Kit,
+	the Inteface Kit can be used to create a responsive and attractive graphical
+	user interface.
+
+ 	The most important class in the Interface Kit is the BView class, which
+	handles drawing and user interaction. Pointer and keyboard events are
+	processed in this class. 
+
+	Another important class is the BWindow class, which holds BViews and makes
+	them visibile to the user. The BWindow class also handles BView focusing
+	and BMessage dispatching, among other things.
+
+	A new addition Haiku has added over the BeOS API is the Layout API, which
+	is based around the BLayoutItem and BLayout classes. These classes will
+	take care of making sure all your GUI widgets end up where you want them,
+	with enough space to be useful. You can start learning the Layout API 
+	by reading the \link layout_intro introduction \endlink.
+*/