summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/source/index.rst17
1 files changed, 7 insertions, 10 deletions
diff --git a/doc/source/index.rst b/doc/source/index.rst
index ed6d35fa1..1b532afb1 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -4,18 +4,15 @@
contain the root `toctree` directive.
-BuildStream Documentation
-=========================
+Welcome to BuildStream’s documentation!
+=======================================
-About BuildStream
------------------
-BuildStream is a flexible and extensible framework for the modelling of build
-pipelines in a declarative YAML format, written in python.
-
-These pipelines are composed of abstract elements which perform mutations on
-*filesystem data* as input and output, and are related to eachother by their
-dependencies.
+These docs cover everything you need to build and integrate software stacks
+using BuildStream.
+They begin with a basic introduction to BuildStream, background
+information on basic concepts, and a guide to the BuildStream command line interface.
+Later sections provide detailed information on BuilStream internals.
.. toctree::
:maxdepth: 2