Skip to content

Commit 01f43b8

Browse files
author
Keith Coleman
committed
Add collab notes docs
1 parent d71d81a commit 01f43b8

2 files changed

Lines changed: 57 additions & 0 deletions

File tree

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: Collaborative Notes
3+
description: AI-drafted notes that update with community input
4+
navWeight: 65
5+
---
6+
# Collaborative Notes
7+
8+
Collaborative Notes are a new way for the community to add context to posts. They're created when contributors request a note, and improve through suggestions and ratings from the community. They're written and updated by AI, using community input. It's new approach to the public working together with AI.
9+
10+
This is a new, experimental feature, and we expect it to evolve based on contributor feedback.
11+
12+
![A Collaborative Note on a post](../images/collaborative-notes.png)
13+
14+
## How Collaborative Notes are created
15+
16+
Collaborative Notes are generated when contributors tap "Request a Note" on a post. This alerts other contributors (as it always has), and now also kicks off creation of a Collaborative Note. The requester is notified when the note is ready, and can rate and suggest improvements to it.
17+
18+
Currently, requests from [Top Writers](./top-contributors.md) on English-language posts generate Collaborative Notes. Over time, we expect to expand this so requests from more contributors generate them as well.
19+
20+
## How to interact with Collaborative Notes
21+
22+
### Rate them
23+
24+
Collaborative Notes can be rated just like any other Community Note. Your ratings help determine whether a Collaborative Note earns the status of Helpful and gets shown on the post.
25+
26+
### Suggest improvements
27+
28+
When rating a Collaborative Note, you can also suggest an improvement. Suggestions appear as part of the rating form — tap the same "submit" button to submit both your rating and suggestion.
29+
30+
Currently, suggesting improvements is available to contributors with 2+ [Writing Impact](./writing-and-rating-impact.md). Availability will likely expand over time.
31+
32+
To edit or delete a suggestion, edit or delete your rating on the note.
33+
34+
## How Collaborative Notes update
35+
36+
Collaborative Notes can update over time as suggestions and ratings come in. When considering an update, the system reviews new input from contributors to make the note as helpful as possible, then decides whether the new version is a meaningful improvement.
37+
38+
If you make a suggestion and the note gets updated, you'll be notified. You'll also be able to see whether your suggestion was incorporated, and why or why not.
39+
40+
### Revision history
41+
42+
When looking at a Collaborative Note, you can tap "Revision history" to see older versions of the note.
43+
44+
## How Collaborative Notes earn status
45+
46+
Collaborative Notes are scored like all Community Notes. If enough contributors from [different points of view](./diversity-of-perspectives.md) rate a note as helpful, it earns a status of Helpful and starts showing on X.
47+
48+
## Transparency
49+
50+
Collaborative Notes are designed with the same transparency principles as the rest of Community Notes:
51+
52+
- **Open-source code**: The note generation code, including prompts and logic, is [open-source](https://github.com/twitter/communitynotes)
53+
- **Public data**: Collaborative Notes and suggestions are included in the [public data downloads](../under-the-hood/download-data.md)
54+
55+
## Collaborative Impact
56+
57+
We're exploring Collaborative Impact points to go alongside [Writing and Rating Impact](./writing-and-rating-impact.md), so contributors can see the impact of their suggestions.
115 KB
Loading

0 commit comments

Comments
 (0)