Skip to content

[Weave] annotation queue docs-1869#2119

Open
anastasiaguspan wants to merge 10 commits intomainfrom
weave-annotation-q-docs-1869
Open

[Weave] annotation queue docs-1869#2119
anastasiaguspan wants to merge 10 commits intomainfrom
weave-annotation-q-docs-1869

Conversation

@anastasiaguspan
Copy link
Contributor

Description

Adding two new pages under "monitor and collect feedback" -> Annotate:

  1. Set up annotation queues
  2. Review items in an annotation queue

Testing

  • [ x] Local build succeeds without errors (mint dev)
  • [ x] Local link check succeeds without errors (mint broken-links)
  • PR tests succeed

Related issues

@anastasiaguspan anastasiaguspan requested a review from a team as a code owner February 4, 2026 13:26
@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

Images automagically compressed by Calibre's image-actions

Compression reduced images by 73.9%, saving 393.5 KB.

Filename Before After Improvement Visual comparison
weave/guides/tracking/imgs/AnnotationAddTraces.png 251.8 KB 71.7 KB 71.5% View diff
weave/guides/tracking/imgs/AnnotationSubmitItem.png 103.6 KB 23.0 KB 77.8% View diff
weave/guides/tracking/imgs/AnnotationCreateField.png 71.8 KB 17.9 KB 75.1% View diff
weave/guides/tracking/imgs/AnnotationTracesFilter.png 63.6 KB 17.4 KB 72.6% View diff
weave/guides/tracking/imgs/AnnotationQueues.png 41.9 KB 9.2 KB 78.0% View diff

@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (2 total)

📄 Pages (2)

File Preview
weave/guides/tracking/annotation-queues.mdx Annotation Queues
weave/guides/tracking/annotation-review.mdx Annotation Review

📝 Changed (1 total)

⚙️ Other (1)
File
docs.json

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 0fe05a6 at 2026-02-20 22:00:05 UTC

@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

🔗 Link Checker Results

⚠️ Some issues were detected

Checked against: https://wb-21fd5541-weave-annotation-q-docs-1869.mintlify.app


Summary

Status Count
🔍 Total 18
✅ Successful 13
⏳ Timeouts 0
🔀 Redirected 4
👻 Excluded 0
❓ Unknown 0
🚫 Errors 1
⛔ Unsupported 0

Errors per input

Errors in weave/guides/tracking/annotation-queues.mdx

Redirects per input

Redirects in ko/weave.mdx

Redirects in models/track/workspaces.mdx

Redirects in weave/guides/tracking/annotation-queues.mdx

Copy link
Contributor

@chance-wnb chance-wnb left a comment

Choose a reason for hiding this comment

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

Thanks, overall great work. I shared some initial thoughts from an feature author perspective. Maybe you also want a doc team member to sign off to ensure it is compliant to the doc team's standards.

In the trace pane header, you can click the Trace ID suffix (for example, "b3ea") to open a panel showing the full trace details for the call.
</Tip>

If any annotator has already reviewed an item in the queue, both pane headers of the review interface are decorated with "Has feedback" and "Response submitted" indicators.
Copy link
Contributor

Choose a reason for hiding this comment

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

I feel it is necessary to explain to the user what is going to happen if a queue item has already been annotated?

  1. Can another user still give feedback(annotate) to the same queue item?
  2. What is the implications if another user still give feedback? how would it impact the current queue reviewing progress?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I agree the Docs should clarify this. But, do we know the answers or has this behavior not been sorted out yet?

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes the answers are (at the moment):

  1. Yes.
  2. Only the first annotation will advance the queue’s overall progress. Later users may still leave feedback on completed items, but their comments will be separate—they will not alter or remove the original feedback, nor will they change the item’s status. We do not track subsequent edits, aside from allowing users to submit feedback on a completed call. This maintains consistency, since users can already freely edit their own feedback from the call details pane even without the annotation feature.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

So question about2: If i navigate to like Item 2 of 5, and someone else already had submitted feedback for that item (thus it has the "Has feedback" and "Response submitted" indicators)... what does the submit button say: does is say 'Submit' or does it say 'Edit feedback'? Hopefully it says 'Submit' based on what you describe above (and i know that if I am the one that had already entered that feedback that it would say 'Edit Feedback' which makes sense).

Copy link
Contributor

@chance-wnb chance-wnb Feb 11, 2026

Choose a reason for hiding this comment

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

You have a good point here, however the current implementation doesn't make a distinction yet and always say "Edit feedback". It can be a logical defect we tolerate, otherwise lets backlog a bug for now.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

okay, i guess I should add a Note then to the docs that if you were not the annotator to originally submit the feedback, that this button will not edit the feedback but will instead make an additional feedback entry for this item.

@anastasiaguspan anastasiaguspan force-pushed the weave-annotation-q-docs-1869 branch from 16c1bd3 to 12d68ef Compare February 9, 2026 21:12
@github-actions
Copy link
Contributor

github-actions bot commented Feb 9, 2026

Images automagically compressed by Calibre's image-actions

Compression reduced images by 74%, saving 407.0 KB.

Filename Before After Improvement Visual comparison
weave/guides/tracking/imgs/AnnotationAddTraces.png 251.8 KB 71.7 KB 71.5% View diff
weave/guides/tracking/imgs/AnnotationSubmitItem.png 103.6 KB 23.0 KB 77.8% View diff
weave/guides/tracking/imgs/AnnotationCreateField.png 71.8 KB 17.9 KB 75.1% View diff
weave/guides/tracking/imgs/AnnotationTracesFilter.png 63.6 KB 17.4 KB 72.6% View diff
weave/guides/tracking/imgs/AnnotationQueues.png 41.9 KB 9.2 KB 78.0% View diff
weave/guides/tracking/imgs/AnnotationLinkToQueue.png 17.3 KB 3.8 KB 78.2% View diff

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 6.4%, saving 5.7 KB.

Filename Before After Improvement Visual comparison
weave/guides/tracking/imgs/AnnotationAddTraces.png 71.7 KB 66.9 KB 6.7% View diff
weave/guides/tracking/imgs/AnnotationTracesFilter.png 17.4 KB 16.5 KB 5.3% View diff

4 images did not require optimisation.

Copy link
Contributor

@dbrian57 dbrian57 left a comment

Choose a reason for hiding this comment

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

This is really well structured and thorough! Minor stuff inline.


You can still provide feedback for an item even if it has already been reviewed by someone else. In this case, although the feedback submission button will still say **Edit feedback**, it will create a new feedback entry with your responses.
<Note>
If you submit feedback to an item already reviewed by someone else, your feedback will be stored **in addition to** the original annotator's feedback.
Copy link
Contributor

Choose a reason for hiding this comment

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

Again, I don't this this needs to be a note and can be rewritten to use present tense and more active voice, like this:

Suggested change
If you submit feedback to an item already reviewed by someone else, your feedback will be stored **in addition to** the original annotator's feedback.
If you submit feedback on an item that has already been reviewed by someone else, Weave stores the feedback **in addition to** the original annotator's feedback. It does not edit or overwrite the original feedback.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I fixed the tense, but for now i'm leaving the note because 1. in this case it is intentionally redundant to the printed text (said a different way) - e.g. if they really are scanning right past note boxes they are still safe.
if it wasn't a note box, it would have to be removed because it is redundant - but in this case we need to highlight this because it is kinda like a 'known bug' that they cannot currently address. so i'm trying to catch both cases, those that only read the important notes and those that skip them. (we did this a lot in AWS, knowing the same fact you mentioned, some people don't see note boxes. But general sentiment at AWS was there is a subclass that skims so hard they only see note boxes, so for important stuff we kinda did both. happy to chat this out further and align with the team.)

Co-authored-by: Dan Brian <daniel.brian@gmail.com>
@chance-wnb
Copy link
Contributor

Hi @anastasiaguspan so sorry to deliver this message. but in a recent PR, we are going to rename

Has feedback -> Has annotation
Edit feedback -> Edit annotation
Confirm feedback -> Confirm annotation

Change is made from https://github.com/wandb/core/pull/39315

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.

3 participants