Set up Data Docs

Data Docs translate Expectations, Validation Results, and other metadata into clean, human-readable documentation. Automatically compiling your data documentation from your data tests in the form of Data Docs guarantees that your documentation will never go stale.

In the previous steps, when you executed the last cell in the Jupyter notebook, Great Expectations used the Expectation Suite you generated to validate the January data batch. It then compiled those validation results to HTML, and opened a browser window with a Data Docs validation results page:


The validation results page is descriptive: it describes how a specific batch of data (in this case, the data we profiled) actually looked when validated, by showing the Observed Value that was found in the data batch. The validation results page is also prescriptive: it shows you your normative Expectation in human-readable form. Comparing what was expected and what was observed lets the validation result provide a Status that tells you whether the observed value passed or failed the validation.

If you scroll down, you will once again find the Expectation we defined for our passenger_count column, this time in human-readable format: “distinct values must belong to this set”. We also see the observed value for this batch, which is exactly the numbers 1 through 6 that we expected. This makes sense, since we’re developing the Expectation using the January data batch.


Feel free to click around and explore Data Docs a little more. You will find two more interesting features:

  1. If you click on the Home page, you will see a list of all validation runs.

  2. The Home page also has a tab for your Expectation Suites. The Expectation Suite pages show you the exclusively prescriptive view of your data.

For now, your static site is built and stored locally. In the last step of the tutorial, we’ll explain options for configuring, hosting and sharing it.

But first, in the next step, we will complete the Great Expectations workflow by showing you how to validate a new batch of data with the Expectation Suite you just created!