diff --git a/doc/sphinx/introduction/how_to_use_this_manual.md b/doc/sphinx/introduction/how_to_use_this_manual.md index 3eafadae6..a3965d9da 100644 --- a/doc/sphinx/introduction/how_to_use_this_manual.md +++ b/doc/sphinx/introduction/how_to_use_this_manual.md @@ -6,40 +6,40 @@ The manual is a large document with a lot of information for different audiences ## What information is covered -The manual is build up out of six different parts, which can be viewed in the left side bar. This section explain what the goal and target audience is of each section. +The manual is built up out of six different parts, which can be viewed in the left side bar. This section explains the goal and target audience of each section. 1. **Introduction** - By now you probably have read through most of this part of the manual already. The goal of this section is to contain the minimum amount of information needed to get started with the the rest of the manual. It briefly explain what the GWB is to new and potential users and explain how to use the manual. + By now you probably have read through most of this part of the manual already. The goal of this section is to contain the minimum amount of information needed to get started with the rest of the manual. It briefly explains what the GWB is to new and potential users and how to use the manual. 2. **User Manual** - This is the main place new users should start. This part starts by explaining how to install the GWB in different cases (for example on different operating systems). Then it contains a brief section on how to use the different applications which are provided by the world builder. Next it core concepts behind the GWB are discussed. The main section of this part is the Basic Starter Tutorial. It will guide you, step-by-step, through building a full 3D (and 2D) geodynamic setup. The last section of the part contains a list of cookbooks, which are specific self-contained tutorials on different aspects of using the GWB. + This is the main place new users should start. This part starts by explaining how to install the GWB in different cases (for example on different operating systems). Then it contains a brief section on how to use the different applications provided by the world builder. Next, the core concepts behind the GWB are discussed. The main section of this part is the Basic Starter Tutorial. It will guide you, step-by-step, through building a full 3D (and 2D) geodynamic setup. The last section of this part contains a list of cookbooks, which are specific self-contained tutorials on different aspects of using the GWB. 3. **API Manual** - This part of the manual is for geodynamic model developers who want be able to use the GWB in their code. It explains how the API is designed, what the available function are in C++ and in the other supported languages. + This part of the manual is for geodynamic model developers who want be able to use the GWB in their code. It explains how the API is designed and discusses the available functions in C++ and in the other supported languages. 4. **Developer manual** - This part of the manual is for users who want to implement a new feature and (hopefully) contribute it back to the GWB. It goes to the whole process of setting up a development environment, explaining how you can contribute code, documentation or by helping with reviewing pull requests, to explaining how the code is structured and how to for example make a new plugin or tool. + This part of the manual is for users who want to implement a new feature and (hopefully) contribute it back to the GWB. It goes to the whole process of setting up a development environment, explaining how you can contribute code, documentation or help with reviewing pull requests, to explaining how the code is structured and how to make a new plugin or tool. 5. **Parameter Listings** - This part is important for all users. It contains a list of all the parameters which are available in the world builder input files and the GWB tools. + This part is important for all users. It contains a list of all available parameters in the world builder input files and the GWB tools. 6. **Project Links** - This part contains links which are relevant to the project. + This part contains links relevant to the project. ## Using the Functionality Now that you know what to find where in the manual, let's explain the interface and how to use it. -**Left panel** We already talked about the left panel in the previous section, but there are a few other things to note. First of all, there is a search box, which may help you to find the content you need. Secondly, when you click on the logo, you are taken back to the opening page of the manual. Lastly, you can hide the side panel, by clicking the icon with the three horizontal bars at the top, just right from the left side panel. +**Left panel** We already talked about the left panel in the previous section, but there are a few other things to note. First of all, there is a search box, which may help you to find the content you need. Secondly, when you click on the logo, you are taken back to the opening page of the manual. Lastly, you can hide the side panel by clicking the icon with the three horizontal bars at the top, just right from the left side panel. **Top panel** This top panel contains on the left side the button to hide and reveal the left panel, and on the right side three very useful buttons. The left most of these buttons sets the page in full screen. Unfortunately, it will currently not stay in full screen when switching between pages. The middle button is probably the most important one. It opens a drop down menu with a direct link to the GWB GitHub repository, a direct link to open a new issue and a direct link to edit the page you are currently on. So if you see a mistake or something is missing on the page, it is very easy to fix without needing to download anything! The rightmost button allows you to download the page you are currently on. **Right panel** The right panel contains an outline of the page you are on. This is especially useful for longer pages. -**Navigation** At the bottom of each page there are buttons to go the the next and previous page. You can also use the arrow keys instead to move the the next and previous page. \ No newline at end of file +**Navigation** At the bottom of each page there are buttons to go to the next and previous page. You can also use the arrow keys instead to move to the next or previous page. \ No newline at end of file diff --git a/doc/sphinx/introduction/what_is_the_gwb.md b/doc/sphinx/introduction/what_is_the_gwb.md index 67a8151f5..8f6b6b275 100644 --- a/doc/sphinx/introduction/what_is_the_gwb.md +++ b/doc/sphinx/introduction/what_is_the_gwb.md @@ -6,14 +6,14 @@ The geodynamic models can be divided in **three broad classes**. 1. **Simple synthetic models:** - This class which involve simplistic geometries for generic modeling and are easy to make and parameterize. These are good for simplified problems and benchmarks. + This class involves simplistic geometries for generic modeling that are easy to make and parameterize. These are good for simplified problems and benchmarks. 2. **Data driven models:** - This class which consists of initial conditions (semi-)automatically derived from datasets like tomography. These are often used for instantaneous models. + This class consists of initial conditions (semi-)automatically derived from datasets like tomography. These are often used for instantaneous models. 3. **Complex synthetic models:** - The case which blends complex 3d interpretation driven detailed geometrical features and thermal fields. This can be useful to parameterize instantaneous models or make setups for models starting in the past. + This case blends complex 3d interpretation-driven detailed geometrical features and thermal fields. This can be useful to parameterize instantaneous models or make setups for models starting in the past. -**The GWB has been designed to make the third case a *lot* easier**, but can also be used to design simple synthetic models and several types of datasets are supported to be used to setup models in a way which aligns with the GWB design philosophies. +**The GWB has been designed to make the third case a *lot* easier**, but can also be used to design simple synthetic models, and several types of datasets are supported to be used to setup models in a way which aligns with the GWB design philosophies. Besides setting up initial conditions for geodynamic models, the GWB can also be used to make detailed 3D visualizations of geologic and geodynamic settings (see {ref}`part:user_manual:chap:how_to_use_the_apps:sec:gwb-grid_app`)