How about review by people who're here this week: @rlgomes @go-oleg @davidvgalbraith

Overall I think this does a great job of introducing juttle.

Some thoughts

• Where will a reader typically be coming from when reading this tutorial? I think having a basic understanding of the anatomy of a juttle program shown here is prereq for going through this tutorial.
• The to-be-added join example will also serve to demonstrate that a flowgraph can start with two sources. Perhaps it would be good to have an example in here that shows a flowgraph can end in two sinks as well (all the current examples branch and merge in the middle).
• Weave more links to "advanced" features of juttle (e.g. features like functions, subs, and user defined reducers which allow for more modular programming).

Addressed the review comments (thanks guys) except these two:

• add example that shows a flowgraph can end in two sinks - will think about where to fit it
• Weave more links to "advanced" features of juttle (e.g. features like functions, subs, and user defined reducers which allow for more modular programming). - unclear on this one:

@go-oleg did you mean to just add them as "juttle has these features but tutorial doesn't cover them", or to actually include them in the tutorial? If the latter, i'm not coming up with useful places to put a function here, much less a reducer. There are places where I can utilize a sub.

Sections on join and ES are new and need review, @rlgomes and @davidvgalbraith please.

@henridf your review would be most welcome, as you fathered the first version of this tutorial (a lot of it stayed true to the original).

still todo:

• add screenshots of output. I first thought of including them as links, so the user would click if interested, or proceed to do the steps themselves without "cheating". However the dense text / code is starting to seem threatening, perhaps inlining the output will make the doc an easier read. Thoughts on that?
• figure out what to do with the ending, where we peter out on input controls, since the only supported ones are still just text and number. None of that juttle-powered goodness works today in outrigger.
• put the data under outrigger/demos/github-tutorial

I was hoping throughout the tutorial, but you're right in that its going to be complicated. Maybe some links at the end of the tutorial along the lines of "go here next":

• list of built in procs
• subs and functions
• custom reducers

A thought for further out - once there is a Google BigQuery adaptor, it would be compelling to use that to pull data rather than use a static file.

TODO:

• change ES data to use single-index schema instead of daily
• fix up the ending of tutorial with inputs as soon as they work in outrigger

As the tutorial work moved to Outrigger, I suppose this PR won’t ever get merged ⇒ closing.

@dmehra If I am mistaken, please reopen.

Will reopen because we still want the main tutorial doc merged into juttle for publishing as part of the docs site, I think, so all local docs links would work (and a big part of this doesn't use outrigger).