Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

edit paragraph #28

Open
wants to merge 12 commits into
base: master
Choose a base branch
from
5 changes: 3 additions & 2 deletions video/scribblings/intro.scrbl
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,9 @@ stream. Thus, Video allows authors to write videos in a
similar fashion to how LaTeX enables authors to write
documents.

All VidLang programs begin with @code{#lang video}, the
remaining program is a description of the resulting video.
All VidLang programs begin with the language declaration @code{#lang video}; and the
remaining program below is a description of the resulting video, written in expressions.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would change this to be:

remaining program is a description of the resulting video.

Because:

  1. What does 'above' have to do with anything?
  2. A Video program is more than just expressions.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was an attempt to introduce "expressions" in the paragraph below. I wasn't sure if the program only contained expressions or not.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see. Honestly, I think that expressions should evaluate to producers deserves its own sentence.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Go for it.


Each top level expression is a @deftech["producer"] which is
anything that produces a video stream. For example, the
@racket[color] producer generates a stream of green frames:
Expand Down