update documentation

playbook/1_define.md

@@ -6,6 +6,7 @@ We first define our website and add our zola template to it.
 !!website.define 
     name:'www2_threefold' 
     title:'Threefold Development'
+    description: "ThreeFold is the world’s first system enabling anyone to become a cloud and internet service provider."
 
 !!website.template_add url:'https://github.com/freeflowuniverse/webcomponents/tree/main/zola'
 ```

playbook/2_people.md

@@ -1,9 +1,8 @@
 ## People
 
-Here, we add the people we want to display in the people page. The people we want to add are defined in the `people` collection, so we need to add the file from the `people` collection which defines the person.
+In this page, we add the people we want to display in the people section. The people we want to add are defined in the `people` collection of `threefold_data`, so we need to add the file from the `people` collection which defines the person.
 
-
-Note that the order we add the people determines the order in which they are listed in.
+First we define the title and description of our people section.
 
 ```js
 !!website.people_add 
@@ -13,6 +12,7 @@ Note that the order we add the people determines the order in which they are lis
 
 ```
 
+Note that above we chose to sort by the order we add the people. As such, the order below determines the order in which they are listed in.
 
 ```js 
 !!website.person_add pointer:'people:kristof_de_spiegeleer.md'

playbook/3_news.md

@@ -1,5 +1,17 @@
 ## News
 
+We add a news section to our website:
+
+```js
+!!website.news_add 
+    title: 'News'
+    sort_by: date
+```
+
+Note that we chose the template
+
+we add the news articles we want to display in the news section section. The people we want to add are defined in the `people` collection of `threefold_data`, so we need to add the file from the `people` collection which defines the person.
+
 ```js
 !!website.news_add pointer:'newsroom:2020_rewind_grid_24.md'
 !!website.news_add pointer:'newsroom:2021_review_2022_preview.md'