Re: Structured Streaming Programming Guide Improvements + Versionless Docs Update

2024-08-25 Thread Neil Ramaswamy
Awesome, I'm glad that others think this is a good idea. I'd love a review of the initial splitting apart PR if you have a chance. And I have plans to break up the guide and refine the content even further; my personal Structured Streaming docs site

Re: Structured Streaming Programming Guide Improvements + Versionless Docs Update

2024-08-25 Thread Anish Shrigondekar
+1 - I think it would be super helpful to split this single long doc. Couple of points that might be useful: - If we could create an individual page per operator with some concrete examples, that would be great - As Jungtaek mentioned, separating the API reference from the conceptual portions migh

Re: Structured Streaming Programming Guide Improvements + Versionless Docs Update

2024-08-25 Thread Jungtaek Lim
Sorry for the late reply. I'm strongly supportive about the initial movement, splitting a crazy long one page of guide doc into multiple pages. If anyone ever looks at the SS guide doc page, they would agree that anyone can't simply say "RTFM" to learn about SS or use the page as reference. The Ch

Re: Structured Streaming Programming Guide Improvements + Versionless Docs Update

2024-08-23 Thread Neil Ramaswamy
Since it's been over 72 hours with no objections, I'm going to make a PR with this change. If you have any specific opinions, we can discuss them on GitHub. Neil On Tue, Aug 20, 2024 at 12:11 AM Neil Ramaswamy wrote: > Hi all, > > A few months ago, I started a thread about migrating our program

Structured Streaming Programming Guide Improvements + Versionless Docs Update

2024-08-19 Thread Neil Ramaswamy
Hi all, A few months ago, I started a thread about migrating our programming guides to be versionless. I had a POC, and the mostly-positive reception on the thread encouraged me to implement it for real. I did that recently here , but there w