Skip to content

add doc comment for execution stage struct - #80

Merged
robtandy merged 2 commits into
mainfrom
robtandy/doc_comment_for_execution_stage
Aug 7, 2025
Merged

add doc comment for execution stage struct#80
robtandy merged 2 commits into
mainfrom
robtandy/doc_comment_for_execution_stage

Conversation

@robtandy

@robtandy robtandy commented Aug 6, 2025

Copy link
Copy Markdown
Collaborator

Re-add back doc comment for execution stage struct.

@gabotechs gabotechs left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💯

@NGA-TRAN NGA-TRAN left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are a few typos

Comment thread src/stage/stage.rs Outdated
/// When an [`ExecutionStage`] is execute()'d if will execute its plan and return a stream
/// of record batches.
///
/// If the stage has input stages, then it those input stages will be executed on remote resources

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// If the stage has input stages, then it those input stages will be executed on remote resources
/// If the stage has input stages, those input stages will be executed on remote resources

Comment thread src/stage/stage.rs
/// If the stage has input stages, then it those input stages will be executed on remote resources
/// and will be provided the remainder of the stage tree.
///
/// For example if our stage tree looks like this:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sentence does not sound finish

Comment thread src/stage/stage.rs Outdated
///
/// The receiving ArrowFlightEndpoint will then execute Stage 2 and will repeat this process.
///
/// When Stage 4 4 is executed, it has no input tasks, so it is assumed that the plan included in that

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// When Stage 4 4 is executed, it has no input tasks, so it is assumed that the plan included in that
/// When Stage 4 is executed, it has no input tasks, so it is assumed that the plan included in that

@robtandy

robtandy commented Aug 7, 2025

Copy link
Copy Markdown
Collaborator Author

Thanks for these @NGA-TRAN ! I addressed.

@robtandy
robtandy merged commit 8971edd into main Aug 7, 2025
2 of 3 checks passed
@robtandy
robtandy deleted the robtandy/doc_comment_for_execution_stage branch August 7, 2025 14:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants