doc: Adding part 1 of the getting started tutorial

  o doc/Makefile: Added new directory to collect rst files from

  o doc/examples/first-project: Added the "first-project" example
    project.

  o doc/source/sessions/first-project-*.html: Added the generated
    snippets

  o doc/source/using_tutorial.rst: Added the new main tutorial page

  o doc/source/tutorial/first-project.rst: Added part 1 of the tutorial here

  o tests/examples/first-project.py: Added test for the example project

This is largely based on an example by Javier Jardón, which was
submitted at https://gitlab.com/BuildStream/buildstream/merge_requests/323

Fixes #103

3 files changed, 21 insertions, 0 deletions

diff --git a/doc/examples/first-project/elements/hello.bst b/doc/examples/first-project/elements/hello.bst
new file mode 100644
index 000000000..d23ebc7b6
--- /dev/null
+++ b/doc/examples/first-project/elements/hello.bst
@@ -0,0 +1,13 @@
+kind: import
+
+# Use a local source to stage our file
+sources:
+- kind: local
+  path: hello.world
+
+# Configure the import element
+config:
+
+  # Place the content staged by sources at the
+  # root of the output artifact
+  target: /
diff --git a/doc/examples/first-project/hello.world b/doc/examples/first-project/hello.world
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/doc/examples/first-project/hello.world
diff --git a/doc/examples/first-project/project.conf b/doc/examples/first-project/project.conf
new file mode 100644
index 000000000..2182d35a1
--- /dev/null
+++ b/doc/examples/first-project/project.conf
@@ -0,0 +1,8 @@
+# Unique project name
+name: first-project
+
+# Required BuildStream format version
+format-version: 9
+
+# Subdirectory where elements are stored
+element-path: elements