I just came across this page of the docs which hasn't been changed much since Dec 2018. I think it would be useful to update it to include a runnable example and some information about the Layer class.

Once that page is updated, it will probably make sense to update https://docs.dask.org/en/latest/phases-of-computation.html and https://docs.dask.org/en/latest/graphs.html to make it clearer how HLGs fit in.

I am happy to take on this work, but just wanted to put this here in case I am missing something.

Some resources that I am planning to draw on:
Layer Issue
Blog post about scheduling
Scheduling workshop from summit

Pinging the people who I have seen working on HLG related things: @rjzamora @GenevieveBuckley @gjoseph92 @ian-r-rose @jrbourbeau