Skip to content

fix: automatically document the availability & lifecycle of variables#16043

Open
isubasinghe wants to merge 18 commits intoargoproj:mainfrom
pipekit:auto-document-expressions
Open

fix: automatically document the availability & lifecycle of variables#16043
isubasinghe wants to merge 18 commits intoargoproj:mainfrom
pipekit:auto-document-expressions

Conversation

@isubasinghe
Copy link
Copy Markdown
Member

@isubasinghe isubasinghe commented Apr 27, 2026

Motivation

This is the initial part of making expressions better. Currently we have no documentation on the lifecycle and variables provided in expressions.
This PR attempts to solve that particular problem.

Modifications

Added a catalog and a key based way to populate the scope. This means that all variables available are documented in the catalog.

Verification

Tests pass.

Documentation

Documentation is automatically generated.

AI

Claude was used but this is still very much manually guided.

Signed-off-by: isubasinghe <isitha@pipekit.io>
@isubasinghe isubasinghe changed the title fix: automatically document the availability lifecycle of variables. fix: automatically document the availability & lifecycle of variables Apr 27, 2026
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
@isubasinghe isubasinghe force-pushed the auto-document-expressions branch from 613d8ce to 2d0d271 Compare April 27, 2026 06:41
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
Signed-off-by: isubasinghe <isitha@pipekit.io>
@isubasinghe isubasinghe marked this pull request as ready for review April 29, 2026 03:36
@isubasinghe isubasinghe requested a review from Joibel April 30, 2026 03:01
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.

1 participant