Merge branch 'main' of github.com:sartography/spiffworkflow_website into main

content/pages/spiffworkflow.md

@@ -6,7 +6,7 @@ draft: false
 description: A brief introduction to SpiffWorkflow a BPMN/DMN execution library written in python.
 ---
 
-SpiffWorkflow is an open source Python library with source code available on [GitHub](https://github.com/sartography/SpiffWorkflow]) and detailed documentation currently available on [ReadTheDocs](https://spiffworkflow.readthedocs.io/en/latest/).  It is the core library within SpiffArena.  Its target audience is Python developers who want to create custom workflow systems or embed BPMN features into existing applications.
+SpiffWorkflow is an open source Python library with source code available on [GitHub](https://github.com/sartography/SpiffWorkflow]) and detailed documentation available on [ReadTheDocs](https://spiffworkflow.readthedocs.io/en/latest/).  It is the core library within SpiffArena.  Its target audience is Python developers who want to create custom workflow systems or embed BPMN features into existing applications.
 
 ## Build status
 [![Build Status](https://travis-ci.com/sartography/SpiffWorkflow.svg?branch=master)](https://travis-ci.org/sartography/SpiffWorkflow)

content/posts/articles/get_started.md

@@ -12,7 +12,7 @@ In this article (and accompanying video) you will create and run your first exec
 
 ## Install and Start SpiffArena
 
-### Pre-Reqs:
+### Prerequisites:
 You will need to install Docker and Docker-Compose.  Please follow [the Docker Installation instructions](https://docs.docker.com/compose/install/) if you do not have these already.  
 Docker is a way for you to run on your laptop what was designed to run on larger computers and be accessible to many people throughout an organization.  It will not alter your computer, and you can fully remove all the files with a few commands provided at the end of this article.
 

content/posts/articles/visual_workflows.md

@@ -14,18 +14,19 @@ description: A business level introduction to SpiffWorkflow and why we adopted t
 
 SpiffWorkflow allows your python application to process BPMN diagrams (think of them as very powerful flow charts) to accomplish what would otherwise require writing a lot of complex business logic in your code. You can use these diagrams to accomplish a number of tasks, such as:
 
-* Creating an online questionnaire which changes depending on the answers to previous questions;
-* Building a complex approval process that needs to be handed off between multiple people;
-* Allowing non-developers to make iterative changes to the flow of an application over time;
-SpiffWorkflow can do all of this while drastically improving communication within multidisciplinary teams, allowing more people to contribute to your application, and making it more resilient to changing requirements.
+* Creating an online questionnaire which changes depending on the answers to previous questions
+* Building a complex approval process that needs to be handed off between multiple people
+* Allowing non-developers to make iterative changes to the flow of an application over time
+
+SpiffWorkflow can do all of this while drastically improving communication within multidisciplinary teams, allowing more people to contribute to your application and making it more resilient to changing requirements.
 
 ## Visualizing Code is the Future
 
-Visual software development environments are key for handling many of the business problems we need to solve over the coming decade. While there are tons of marketing sites touting “low-code” solutions of nominal value, there are a handful of elegant real-world success stories. I’ve seen them most clearly through the eyes of my son. His introduction to programming was [Scratch](https://scratch.mit.edu/) where basic programming constructs work like building blocks you can stack together. It feels a little like playing with legos, you can build chunks, then stick them together in different ways to see what happens. From there my son moved on to [Blender](https://www.blender.org/), which uses visual tools for the complex process of building 3D animations, taking a dual disciple problem, and providing intuitive visual representation of what is definitely programming. Low-Code using visualization tools is very much a real thing, and it will reshape the way we work with computers in the future to solve complex problems.
+Visual software development environments are key for handling many of the business problems we need to solve over the coming decade. While there are tons of marketing sites touting “low-code” solutions of nominal value, there are a handful of elegant real-world success stories. I’ve seen them most clearly through the eyes of my son. His introduction to programming was [Scratch](https://scratch.mit.edu/), where basic programming constructs work like building blocks you can stack together. It feels a little like playing with legos; you can build chunks and then stick them together in different ways to see what happens. From there my son moved on to [Blender](https://www.blender.org/), which uses visual tools for the complex process of building 3D animations, taking a multidisciplinaryproblem and providing intuitive visual representation of what is definitely programming. Low-Code using visualization tools is very much a real thing, and it will reshape the way we work with computers in the future to solve complex problems.
 
 ## What are Workflows and BPMN
 
-The term “Workflow” can mean many things in software. Our focus is on Business Processes — such as the complex approval process necessary for launching a medical research study at a university (our core use case at the moment). There is a well established standard for visualizing business processes called BPMN (Business Process Modeling Notation) that looks a heck of a lot like a flow chart (see image below). Version 2.0 published in 2010 was designed to be executable. This is important.
+The term “Workflow” can mean many things in software. Our focus is on Business Processes — such as the complex approval process necessary for launching a medical research study at a university (one of our core use cases at the moment). There is a well established standard for visualizing business processes called BPMN (Business Process Modeling Notation) that looks a heck of a lot like a flow chart (see image below). Version 2.0, published in 2010, was designed to be executable. This is important.
 
 {{< figure src="lowcode_diagram.png" caption="Not to delve too deeply, but the arrows in the diagram above dictate motion from one task to the next. The boxes with people are User Tasks, and are often powered by user interfaces that allow real people to provide input. The X’s are crossroads where different paths can be taken. The script tasks (with the piece of curvy paper) are where we can inject brief bits of code to make calculations and call out to other software systems and APIs. This is a very small example of all that is possible within the enormous 538 page BPMN standard, but it is a valid example, and demonstrates that powerful diagramming tools can still be intuitive." >}}
 
@@ -33,7 +34,7 @@ What’s great about BPMN is that you can potentially create software even a CEO
 
 ## What is SpiffWorkflow
 
-BPMN diagrams don’t just run. You need an interpreter that is capable of executing the diagram, in the same way that you need to have the python interpreter to run a python program. SpiffWorkflow is an interpreter for BPMN, that makes the diagram runnable as a part of your Python application.
+BPMN diagrams don’t just run. You need an interpreter that is capable of executing the diagram, in the same way that you need to have the python interpreter to run a python program. SpiffWorkflow is an interpreter for BPMN that makes the diagram runnable as a part of your Python application.
 
 SpiffWorkflow is open source, and released under the GNU Lesser General Public License.