comphead commented on PR #21824: URL: https://github.com/apache/datafusion/pull/21824#issuecomment-4314711626
> I think we should work toward this rather than having generator for each peices like this PR. We probably too overcomplicate things: generators are the last haven, for builtin functions it was made because the std tool like rustdoc was not enough. I feel we need to stick to rustdoc as much as possible, and this particular case should fit IMO. For example refer to `datafusion/core/src/lib.rs` how it documents the `Streaming Execution` and here is the rendered version https://docs.rs/datafusion/latest/datafusion/#streaming-execution -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
