Skip to content

Commit 1c17001

Browse files
Ian ZelikmanIan Zelikman
Ian Zelikman
authored and
Ian Zelikman
committed
Updated some TODOs in part one
1 parent 9b1edb4 commit 1c17001

File tree

3 files changed

+27
-14
lines changed

3 files changed

+27
-14
lines changed

presentation/presentation.html

+13-7
Original file line numberDiff line numberDiff line change
@@ -451,10 +451,11 @@
451451

452452
## Instructions
453453

454-
- Work in `tutorial` directory
454+
- Work in `work` directory
455+
455456
- Save `betterapis.yml`
456-
- Run validator: `TODO: command here`
457-
- Generate UI: `TODO: command here`
457+
458+
- Run validator: `swagger validate tutorial-repo/lessons/lesson-1.02/solution.yaml`
458459

459460
---
460461

@@ -464,11 +465,11 @@
464465

465466
## Done?
466467

467-
- Compare with contents of `solutions/lesson##`
468+
- Compare with contents of `lessons/lesson-x.xx/solution.xxx`
468469

469470
## Stuck?
470471

471-
- Copy `solutions/lesson##/*` to `tutorial`
472+
- Copy `lessons/lesson-x.xx/solution.xxx` to `work`
472473

473474

474475
---
@@ -502,20 +503,25 @@
502503
## Tooling
503504

504505
- Swagger editor:
506+
505507
```
506508
http-server swagger-editor
507509
```
510+
508511
- Validator:
509-
TODO
510512

513+
```
514+
swagger validate tutorial-repo/lessons/lesson-1.02/solution.yaml
515+
```
511516
???
512517
- In the environment you downloaded you will be able to run the **swagger editor** that I will now show.
513518
- There are several examples that come with the editor. We will look at **default.yaml**.
514519
- This is a good basic example of how a spec file will look.
515520
- The spec is very readable and not just easily parsed by automatic tools. But we will look at every
516521
element in detail in later lessons.
517522
- As you start working with the editor. You can see it does very good **validation**.
518-
- TODO validator
523+
- The editor gives you good validation but if you also want to combine working in command line
524+
or want to know how to automate this process you can use the cli.
519525

520526
---
521527
class: lesson

presentation/slides.md

+13-7
Original file line numberDiff line numberDiff line change
@@ -346,10 +346,11 @@ class: lesson
346346

347347
## Instructions
348348

349-
- Work in `tutorial` directory
349+
- Work in `work` directory
350+
350351
- Save `betterapis.yml`
351-
- Run validator: `TODO: command here`
352-
- Generate UI: `TODO: command here`
352+
353+
- Run validator: `swagger validate tutorial-repo/lessons/lesson-1.02/solution.yaml`
353354

354355
---
355356

@@ -359,11 +360,11 @@ class: solution
359360

360361
## Done?
361362

362-
- Compare with contents of `solutions/lesson##`
363+
- Compare with contents of `lessons/lesson-x.xx/solution.xxx`
363364

364365
## Stuck?
365366

366-
- Copy `solutions/lesson##/*` to `tutorial`
367+
- Copy `lessons/lesson-x.xx/solution.xxx` to `work`
367368

368369

369370
---
@@ -397,20 +398,25 @@ class: lesson
397398
## Tooling
398399

399400
- Swagger editor:
401+
400402
```
401403
http-server swagger-editor
402404
```
405+
403406
- Validator:
404-
TODO
405407

408+
```
409+
swagger validate tutorial-repo/lessons/lesson-1.02/solution.yaml
410+
```
406411
???
407412
- In the environment you downloaded you will be able to run the **swagger editor** that I will now show.
408413
- There are several examples that come with the editor. We will look at **default.yaml**.
409414
- This is a good basic example of how a spec file will look.
410415
- The spec is very readable and not just easily parsed by automatic tools. But we will look at every
411416
element in detail in later lessons.
412417
- As you start working with the editor. You can see it does very good **validation**.
413-
- TODO validator
418+
- The editor gives you good validation but if you also want to combine working in command line
419+
or want to know how to automate this process you can use the cli.
414420

415421
---
416422
class: lesson

work/README.md

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
This directory left blank on purpose to store work during the tutorial

0 commit comments

Comments
 (0)