Add notebooks directory with example Typescript notebook.

[ellisonbg]

This PR adds a notebooks directory with configuration to write notebooks in TypeScript that can import from the local lumino packages. There is a sample notebook that does some tests of different serialization schemes for indices. The goal would be to start adding notebook-based narrative documentation for lumino (at least the parts that don't need to render things to the page.

[vidartf]

Thanks for sharing the profiling code! That's useful.

The goal would be to start adding notebook-based narrative documentation for lumino (at least the parts that don't need to render things to the page.

I have a few reservations about that. I might become convinced that having some explanations written as a notebook can have merit, but I don't think it is a good idea to switch to using a non-Node based tool as the main way for writing the docs.

[ellisonbg]

Sorry I wasn't clear - I don't think the notebooks are a substitution for proper narrative docs. But there are some types of things where it really helps to have narrative based examples/docs that can be run and played with.

…

On Thu, Nov 28, 2019 at 2:46 AM Vidar Tonaas Fauske < ***@***.***> wrote: Thanks for sharing the profiling code! That's useful. The goal would be to start adding notebook-based narrative documentation for lumino (at least the parts that don't need to render things to the page. I have a few reservations about that. I might become convinced that having some explanations written as a notebook can have merit, but I don't think it is a good idea to switch to using a non-Node based tool as the main way for writing the docs. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#8?email_source=notifications&email_token=AAAGXUF3SVIZRFRYGP43FATQV6ORLA5CNFSM4JSKGMD2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEFMGWUA#issuecomment-559442768>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAAGXUEUVLRAPR7B5D45GTTQV6ORLANCNFSM4JSKGMDQ> .

-- Brian E. Granger Principal Technical Program Manager, AWS AI Platform (brgrange@amazon.com) On Leave - Professor of Physics and Data Science, Cal Poly @ellisonbg on GitHub

[blink1073]

Thanks!