Consider moving IntroToRx into its own repository
Author: glopesdevCreated Jun 25, 2026Updated Jun 27, 2026
Labels[area] Rx
First of all, thank you so much for the huge effort put into the development and updating of the Intro To Rx book. It is a massive resource for the Rx community.
I am raising this issue mostly for organizational and maintenance purposes. I feel the continuous development of the IntroToRx book should be kept separate from this repository for a few reasons:
- Rx-focus: this repository includes Ix in addition to Rx so there is asymmetry
- update guarantees: while I understand the motivation to have the book track the code and vice-versa, in practice I don't think this is achievable. A genuinely useful book simply requires digestion at a completely different time-scale than the code base, by both readers and writers. By definition it will require updates which are asynchronous to package release cycles.
- search: because the book is mixed in with code, it severely impairs GitHub search potential. If I want to search for e.g.
SubscribeSafeinside the book contents, this is made unnecessarily hard since I will get a list of all the uses of this method in the code base which easily shadows any possible in-book references.
There may be more pros/cons which I may have missed, but these three I believe are already enough to warrant a more dedicated strategic discussion about this.
Source: dotnet/reactive