RFC: [Learning Team] Interactive Documentation

[ghuntley]

RFC: [Learning Team] Interactive Documentation

[havremunken]

This is amazing. One thought; Would it be possible to store code snippets somehow, so that when a newbie appears on slack or SO or something and starts his sentence with "How do I" and we have an example for it, we send him/her the URL and they are immediately in Wonderland?

[ghuntley]

Most definitely

[ghuntley]

Some discussions w/Miguel over at https://reactivex.slack.com/archives/C02AJB872/p1526530008000080

Summary:

• Geoff doesn't want us to maintain a fork of workbooks
• We have forked to get some form of CI/CD story going
• We could PR the upstream project instead of our fork
• Miguel would like to promote our workbook files, and hopefully people can run it with the stock workbooks removing the need to run a fork

Thoughts:

• We should hack away and come up with roadmap/plan of what's needed to get try.reactiveui.net launched based off the binaries that have been published.
• If need be we can do commits in our fork for a little bit, as POC and do super hacky work whilst we learn then focus upstream?

Slack

[ghuntley]

Relevant conversation in Slack - https://reactivex.slack.com/archives/C0PQCKDV1/p1530520704000291

Slack

[worldbeater]

Looks promising! Just tried to make it work—which operating system and .NET Core SDK version does it require? It didn't work for me on Ubuntu 18.04 LTS with .NET Core 2.2 SDK installed, this is the output of dotnet workbooks-server.dll, the react app shows Loading forever in Chrome:

Xamarin Inspector
Copyright 2016-2018 Microsoft. All rights reserved.
Copyright 2014-2016 Xamarin Inc. All rights reserved.
├─ Version: 0.0.0-local
├─ Date: 1/1/01 12:00:00 AM
├─ Hash: @PACKAGE_HEAD_REV@
├─ Branch: @PACKAGE_HEAD_BRANCH@
└─ Lane: @PACKAGE_BUILD_HOST_LANE@

[Info][00:00:00.0330026] ClientApp (Initialize): AppSessionId: 09ea2f01-b52f-49a2-bcae-8e803b7a9a26 @ C:\Dropbox\OSS\reactiveui\try.reactiveui.net\Clients\Xamarin.Interactive.Client\ClientApp.cs:112
[Warning][00:00:00.0493610] MainThread (Ensure): MainThread.Ensure desired in GetValue but MainThread has no associated SynchronizationContext @ C:\Dropbox\OSS\reactiveui\try.reactiveui.net\Agents\Xamarin.Interactive\MainThread.cs:51
[Info][00:00:00.0497031] Telemetry (.ctor): Telemetry is disabled @ C:\Dropbox\OSS\reactiveui\try.reactiveui.net\Clients\Xamarin.Interactive.Client\Telemetry\Client.cs:66
[Warning][00:00:00.0552439] MainThread (Ensure): MainThread.Ensure desired in GetValue but MainThread has no associated SynchronizationContext @ C:\Dropbox\OSS\reactiveui\try.reactiveui.net\Agents\Xamarin.Interactive\MainThread.cs:51
Hosting environment: Production
Content root path: /home/artyom/Github/try.reactiveui.net-binaries
Now listening on: http://127.0.0.1:5000
Application started. Press Ctrl+C to shut down.

It seems try.reactiveui.net is heavily based on Microsoft/workbooks, so I'll try to recompile the app and write back later.