Skip to content

Commit a328ed1

Browse files
committed
Some minor improvements to the walkthroughs
1 parent c292a43 commit a328ed1

File tree

2 files changed

+5
-5
lines changed

2 files changed

+5
-5
lines changed

example1.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ According to Acme's docs, there are no free products. So we need to specify *exc
7070

7171
### Are all tags strings?
7272

73-
Finally, we come to the *tags* property. Unlike the previous properties, tags have many values, and is represented as a JSON array. According to Acme's docs, all tags must be strings, but you aren't required to specify tags. We simply leave *tags* out of the list of required properties.
73+
Finally, we come to the *tags* property. Unlike the previous properties, tags have many values, and is represented as a JSON array. If, according to Acme's docs, all tags must be strings, but you aren't required to specify tags; we would simply leave *tags* out of the list of required properties.
7474

7575
However, Acme's docs add two constraints:
7676

example2.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@ title: Building a mount point schema
55

66
This example shows a possible JSON representation of a hypothetical machine's mount points as represented in an `/etc/fstab` file.
77

8-
An entry in the fstab file can have many different forms. Here is a possible representation of a full fstab:
8+
An entry in an fstab file can have many different forms. Here is a possible representation of a full fstab:
99

1010
```json
1111
{% include example2/instance.json %}
1212
```
1313

14-
Not all constraints to an fstab file can be modeled using JSON Schema alone; however, it can already represent a good number of them. We will add constraints one after the other until we get to a satisfactory result.
14+
Not all constraints to an fstab file can be modeled using JSON Schema alone; however, it can represent a good number of them. We will add constraints one after the other until we get to a satisfactory result.
1515

1616
Base schema
1717
-----------
@@ -149,7 +149,7 @@ This is only an example for learning purposes. Some additional constraints could
149149
- it makes no sense for `/` to be mounted on a tmpfs filesystem;
150150
- it makes no sense to specify the filesystem type if the storage is either NFS or tmpfs.
151151

152-
As an exercise, you can always try and add these constraints. It would probably require splitting the schema further.
152+
As an exercise, you can always try to add these constraints. It would probably require splitting the schema further.
153153

154154
### Not all constraints can be expressed
155155

@@ -163,4 +163,4 @@ While this is not a concern if you know that the schema you write will be used b
163163

164164
- *format* support is optional, and as such other tools may ignore this keyword: this can lead to a different validation outcome for the same data;
165165
- it uses regular expressions: care should be taken not to use any advanced features (such as lookarounds), since they may not be supported at the other end;
166-
- it uses *$schema* to express the need to use draft v6 compliant processing, but not all tools support draft v6 (in fact, most don't support it).
166+
- it uses *$schema* to express the need to use draft v6 compliant processing, but not all tools support draft v6.

0 commit comments

Comments
 (0)