Skip to content

Commit af01c93

Browse files
authored
Add zulip server link to the website (#236)
1 parent 6c68038 commit af01c93

File tree

7 files changed

+93
-6
lines changed

7 files changed

+93
-6
lines changed

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ We welcome many different types of contributions including:
1111
- Bug fixes
1212
- Documentation
1313
- Issue Triage
14-
- Answering questions on Slack/Mailing List
14+
- Answering questions on Zulip/Mailing List
1515
- Web design
1616
- Communications / Social Media / Blog Posts
1717
- Release management
@@ -62,7 +62,7 @@ Before a significant change or addition to the protocol is made, you should like
6262
If you’re unsure about anything, feel free to reach out! The best way to reach us with a question when contributing is to ask on:
6363

6464
- The original GitHub issue or discussion thread
65-
- Slack
65+
- [Zulip](https://agentclientprotocol.zulipchat.com/)
6666

6767
## Code of Conduct
6868

docs/community/communication.mdx

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: "Contributor Communication"
3+
description: "Communication methods for Agent Client Protocol contributors"
4+
---
5+
6+
This document explains how to communicate and collaborate within the Agent Client Protocol (ACP) project.
7+
8+
## Communication Channels
9+
10+
In short:
11+
12+
- **[Zulip](https://agentclientprotocol.zulipchat.com/)**: For real-time or ad-hoc discussions.
13+
- **[RFDs](https://agentclientprotocol.com/rfds/about)**: For proposed changes to the specification.
14+
- **[GitHub Discussions](https://github.com/orgs/agentclientprotocol/discussions)**: For structured, longer-form discussions.
15+
- **[GitHub Issues](https://github.com/agentclientprotocol/agent-client-protocol/issues)**: For actionable tasks, bug reports, and feature requests.
16+
17+
All communication is governed by our [Code of Conduct](https://agentclientprotocol.com/community/code-of-conduct). We expect all participants to maintain respectful, professional, and inclusive interactions across all channels.
18+
19+
### Zulip
20+
21+
For real-time contributor discussion and collaboration. The server is designed around **ACP contributors** and is not intended to be a place for general ACP support.
22+
23+
The Zulip server will have both public and private channels.
24+
25+
[Join the Zulip here](https://agentclientprotocol.zulipchat.com/).
26+
27+
#### Public Channels (Default)
28+
29+
- **Purpose**: Open community engagement, collaborative development, and transparent project coordination.
30+
- Primary use cases:
31+
- **Public SDK and tooling development**
32+
- **Community onboarding** and contribution guidance.
33+
- **Community feedback** and collaborative brainstorming.
34+
- Avoid:
35+
- ACP user support: participants are expected to read official documentation and start new GitHub Discussions for questions or support.
36+
- Service or product marketing: interactions on this Zulip are expected to be vendor-neutral and not used for brand-building or sales. Mentions of brands or products are discouraged outside of being used as examples or responses to conversations that start off focused on the specification.
37+
38+
#### Private channels (Exceptions)
39+
40+
- **Purpose**: Confidential coordination and sensitive matters that cannot be discussed publicly. Access will be restricted to designated maintainers.
41+
- **Strict criteria for private use**:
42+
- **Security incidents** (CVEs, protocol vulnerabilities).
43+
- **People matters** (maintainer-related discussions, code of conduct policies).
44+
- Select channels will be configured to be **read-only**. This can be good for example for maintainer decision making.
45+
- Coordination requiring **immediate** or otherwise **focused response** with a limited audience.
46+
- **Transparency**:
47+
- **All technical and governance decisions** affecting the community **must be documented** in RFDs, GitHub Discussions and/or Issues.
48+
- **Some matters related to individual contributors** may remain private when appropriate (e.g., personal circumstances, disciplinary actions, or other sensitive individual matters).
49+
- Private channels are to be used as **temporary "incident rooms,"** not for routine development.
50+
51+
Any significant discussion on Zulip leads to a potential decision or proposal must be moved to an RFD, GitHub Discussion, or GitHub Issue to create a persistent, searchable record. Proposals will then be promoted to full-fledged PRs with associated work items as needed.
52+
53+
### RFDs
54+
55+
Please refer to the [RFD process](https://agentclientprotocol.com/rfds/about) for how this is managed. This is the primary way to actually create changes to the protocol.
56+
57+
Conversation about a given RFD can take place within the relevant PRs created to move the RFD forward. Or, a discussion within Zulip can be created in the `rfds` channel to discuss in real-time with other contributors.
58+
59+
### GitHub Discussions
60+
61+
For structured, long-form discussion and debate on project direction, features, improvements, and community topics.
62+
63+
When to use:
64+
65+
- Announcements and release communications
66+
- Community polls and consensus-building processes
67+
- Feature requests with context and rationale
68+
- If a particular repository does not have GitHub Discussions enabled, feel free to open a GitHub Issue instead.
69+
70+
### GitHub Issues
71+
72+
For bug reports, feature tracking, and actionable development tasks.
73+
74+
When to use:
75+
76+
- Bug reports with reproducible steps
77+
- Documentation improvements with specific scope
78+
- CI/CD problems and infrastructure issues
79+
- Release tasks and milestone tracking
80+
81+
### Security Issues
82+
83+
**Do not post security issues publicly.** Instead:
84+
85+
1. Contact lead and/or core maintainers, or [email protected] directly.
86+
2. Follow responsible disclosure guidelines.

docs/community/governance.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Note: This document describes how ACP governance is structured today (Zed-led) a
2020
- Companies and individuals with relevant expertise may contact Zed for component-specific administration rights
2121
- The goal of component-specific admins: allowing companies/individuals with specific knowledge and skillsets to administer code they're best equipped to administer
2222
- Example: JetBrains administers [the Kotlin SDK](https://github.com/agentclientprotocol/kotlin-sdk)
23-
- Companies or individuals interested in administration may contact Zed via shared Slack channel or at [email protected]
23+
- Companies or individuals interested in administration may contact Zed via [Zulip](https://agentclientprotocol.zulipchat.com/), shared Slack channel, or at [email protected]
2424
- Access to component administration is granted via _teams_
2525
- These teams have admin permissions to their specific repository/repositories, and write permissions to the [main protocol repository](https://github.com/agentclientprotocol/agent-client-protocol)
2626
- Zed will provide suggested permissions/rule sets for component admins, but admins are free to update these permissions within their repository(ies) as they see fit

docs/docs.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@
101101
"tab": "Community",
102102
"pages": [
103103
"community/governance",
104+
"community/communication",
104105
"community/code-of-conduct",
105106
"community/contributing"
106107
]
File renamed without changes.

docs/rfds/about.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ The project currently has a design team with the [Zed team as the lead (BDFL)](.
5858

5959
## Discussion and Moderation
6060

61-
Detailed discussions often happen on Slack, with PR comments for process decisions. The results of detailed discussions should be incorporated into the relevant RFD. RFD champions actively curate discussions by collecting questions in the FAQ section. If PR discussions become too long, they should be closed, feedback summarized, and reopened with links to the original.
61+
Detailed discussions often happen on [Zulip](https://agentclientprotocol.zulipchat.com/), with PR comments for process decisions. The results of detailed discussions should be incorporated into the relevant RFD. RFD champions actively curate discussions by collecting questions in the FAQ section. If PR discussions become too long, they should be closed, feedback summarized, and reopened with links to the original.
6262

6363
## Licensing
6464

docs/rfds/introduce-rfd-process.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ RFD proposals are merged into the "draft" section if a core team member decides
4242

4343
Once a proposal is moved to draft, code and implementation may begin to land into the PR. This work needs to be properly feature gated and marked with the name of the RFD.
4444

45-
Further discussion on the RFD can take place on Slack if needed.
45+
Further discussion on the RFD can take place on [Zulip](https://agentclientprotocol.zulipchat.com/) if needed.
4646

4747
#### Moving to the "preview" section
4848

@@ -58,7 +58,7 @@ Once accepted, RFDs become living documents that track implementation progress.
5858

5959
### Moderating and managing RFD discussions
6060

61-
Moving RFDs between points in the cycle involve opening PRs. Those PRs will be places to hold dialog and discussion -- but not the only place, we expect more detailed discussions to take place on Slack or other communication channels. RFD owners and champions should actively "curate" discussions by collecting questions that come up and ensuring they are covered in the FAQ. Duplicate questions can be directed to the FAQ.
61+
Moving RFDs between points in the cycle involve opening PRs. Those PRs will be places to hold dialog and discussion -- but not the only place, we expect more detailed discussions to take place on [Zulip](https://agentclientprotocol.zulipchat.com/) or other communication channels. RFD owners and champions should actively "curate" discussions by collecting questions that come up and ensuring they are covered in the FAQ. Duplicate questions can be directed to the FAQ.
6262

6363
If the discussion on the PR gets to the point where Github begins to hide comments, the PR should typically be closed, feedback collected, and then re-opened.
6464

0 commit comments

Comments
 (0)