Skip to content

Commit d49d0ef

Browse files
authored
revamp squads docs post-GA (#448)
1 parent 8a3ae6a commit d49d0ef

6 files changed

+230
-92
lines changed

docs/squads/creating-your-squad.md

+14-10
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,25 @@ description: "Learn how to create your own developer-focused Squad on daily.dev.
99

1010
## What is a Squad?
1111

12-
A Squad is a developer-focused group where members can come together to learn, interact, and engage on topics that matter to them. Think of Squads as tailored online groups specifically for developers. Squads facilitate knowledge sharing, discussions, and peer interactions, making them ideal for teams, projects, communities, or niche interests.
12+
A Squad is a developer-focused group where members can come together to learn, interact, and engage on topics that matter to them. Think of Squads as tailored online communities specifically for developers. Squads facilitate knowledge sharing, discussions, and peer interactions, making them ideal for teams, projects, communities, or niche interests.
1313

1414
A Squad can be **Public** or **Private**:
15-
- **Public Squads**: Featured in the Squad Directory and open for anyone to join.
15+
- **Public Squads**: Open to all developers and discoverable in the Squad Directory. Public Squads enjoy additional benefits like wider exposure and being featured in categories.
1616
- **Private Squads**: Invite-only, ensuring more controlled membership.
1717

1818
## Key Features of Squads
1919

2020
Squads offer several interactive features to create an engaging experience:
2121

22-
**Create a Squad**: Customize your Squad with a unique name, image, and description.
22+
**Create a Squad**: Customize your Squad with a unique name, handle, image, description, and select a category for Public Squads.
2323

24-
**Invite Members**: Bring in developers you know to discuss, share resources, and collaborate. In Public Squads, adding moderators is recommended to manage conversations effectively.
24+
**Invite Members**: Bring in developers to discuss, share resources, and collaborate.
2525

26-
**Post & Share Content**: Depending on settings, posting can be open to everyone or restricted to moderators. Share daily.dev links, external resources, and support discussions with full markdown compatibility.
26+
**Post & Share Content**: Depending on settings, posting can be open to everyone or restricted to moderators. Enjoy full Markdown compatibility for rich discussions.
2727

28-
**Moderation Tools**: As an admin, you have tools to manage posts, comments, and member interactions, fostering a healthy and respectful environment.
28+
**Moderation Tools**: As an admin, you have tools to manage posts, comments, and member interactions.
29+
30+
**Integrate with Work Tools**: Kickstart collaboration by integrating your Squad with work-related tools, such as Slack. This makes setup seamless and enables stronger team alignment.
2931

3032
## How to Create a Squad
3133

@@ -35,17 +37,19 @@ Starting a Squad is easy. Follow these steps:
3537
2. **Name Your Squad**: Choose a name and handle that captures the focus of your Squad.
3638
3. **Add an Image**: Upload a profile image for your Squad, such as a logo or icon.
3739
4. **Write a Description**: Explain the theme, objectives, and member expectations for your Squad.
40+
5. **Select a Category** *(Public Squads Only)*: Choose a category that best fits your Squad from options like Languages, Web, AI, Career, and more.
3841

3942
:::tip
40-
The most active Squads have engaged members. Encourage everyone to contribute, share, and discuss. With the tools provided by daily.dev, you’re set to build a valuable developer community.
43+
The most active Squads have engaged members. Encourage contributions, discussions, and sharing. Leverage daily.dev’s netowrk to build a valuable developer community.
4144
:::
4245

4346
## Squad Visibility: Private vs. Public
4447

4548
When creating a Squad, select the desired visibility:
4649

4750
1. **Private Squads**: Accessible only by invite, with content visible only to members.
48-
2. **Public Squads** (default): Open and discoverable in the Directory, allowing developers to join freely.
49-
3. **Featured Squads**: High-value Public Squads with strong engagement may become featured, gaining increased visibility.
51+
2. **Public Squads**: Open and discoverable in the Squads Directory, allowing developers to join freely.
52+
53+
Public Squads must select a category during setup. Categories like Web, Mobile, AI, and Fun help users discover Squads that align with their interests.
5054

51-
Good luck! We can’t wait to see your community thrive ✨
55+
Good luck! We can’t wait to see your community thrive ✨

docs/squads/featured-squads.md

+59-12
Original file line numberDiff line numberDiff line change
@@ -7,23 +7,70 @@ description: "Learn how to get your Public Squad featured on the daily.dev Squad
77

88
![Squads Directory Feature](https://github.com/user-attachments/assets/fb28a405-1c0d-45f8-a8a2-6cfa278ce84e)
99

10-
The [Public Squads Directory](https://app.daily.dev/squads) on daily.dev is a curated space where community members can discover new and engaging Public Squads. Being featured here significantly boosts your Squad's visibility and membership. If you have a Public Squad and aim to expand its reach, the directory is the perfect place to grow.
10+
The [Squads Directory](https://app.daily.dev/squads) on daily.dev is a curated space where community members can discover new and engaging Public Squads. Being featured in the directory significantly boosts your Squad's visibility and membership. If you have a Public Squad and aim to expand its reach, the directory is the perfect place to grow.
1111

12-
## Eligibility Criteria for Directory Feature
12+
## How to Get Featured in the Directory
1313

14-
To be featured in the daily.dev Public Squads Directory, your Squad must meet the following criteria:
14+
Public Squads are automatically added to the Squads Directory once they are created and as long as they are well-maintained, but being featured in the directory is reserved for top-performing, high-quality Squads that meet specific criteria.
1515

16-
1. **Public Status**: Only Public Squads are eligible. Private Squads and non-public sources are not included in the directory.
17-
2. **Editorial Selection**: Featured Squads are handpicked by our editorial team, ensuring that they represent quality, engagement, and compliance. (See our tips below for enhancing your chances of being selected.)
16+
### Tips for Increasing Your Chances of Being Featured
1817

19-
This focus on editorially curated content ensures that Squads featured in the directory represent the best of daily.dev’s community, offering users a diverse and enriching experience.
18+
1. **Choose the Right Category**: Make sure your Squad is placed in the most relevant category during setup (e.g., Languages, Web, AI). Choosing the right category helps your Squad reach the right audience.
2019

21-
## Tips to Increase Your Chances of Being Featured
20+
2. **Optimize Your Metadata**:
21+
- **Squad Image**: Use an eye-catching and relevant image for your Squad.
22+
- **Description**: Write a clear and compelling description that highlights your Squad’s value and purpose.
23+
- **Engaging Title**: Use a concise and descriptive title that attracts interest.
2224

23-
The decision to feature a Public Squad in the directory is editorial. However, you can increase your chances by following these best practices:
25+
3. **Post High-Quality Content**:
26+
- Share meaningful and engaging posts consistently.
27+
- Curate tutorials, articles, and videos relevant to your community’s interests.
28+
- Use Markdown to format content professionally.
2429

25-
1. **Post High-Quality Content Regularly**: Consistently sharing valuable content is the primary factor for being featured.
26-
2. **Foster Active Engagement**: A thriving community with active discussions and interactions boosts the appeal of your Squad.
27-
3. **Create Meaningful Interactions**: Regular posts and engaging discussions that resonate with your audience can elevate your Squad's appeal.
30+
4. **Foster Active Engagement**:
31+
- Encourage members to participate in discussions and post content.
32+
- Engage with members by responding to comments and sharing feedback.
2833

29-
For any questions regarding Public Squads, feel free to contact us at [[email protected]](mailto:[email protected]).
34+
5. **Grow Your Membership**:
35+
- Actively invite developers who would benefit from your Squad.
36+
- Promote your Squad through external channels like social media or your Slack workspace.
37+
38+
6. **Maintain Compliance**:
39+
- Follow daily.dev’s content guidelines.
40+
- Approve only high-quality, non-spammy posts.
41+
- Monitor and report inappropriate content or behavior to keep your community safe.
42+
43+
## Benefits of Being Featured
44+
45+
Featured Squads gain several advantages that help them grow faster:
46+
47+
- **Increased Visibility**: Featured Squads are prominently displayed in the directory, making them more discoverable.
48+
- **Credibility Boost**: The "Featured" badge signals quality and authority, encouraging more developers to join.
49+
- **Engagement Opportunities**: Featured Squads often attract more active members, driving richer discussions and interactions.
50+
51+
## Directory Categories
52+
53+
The directory organizes Squads into categories to help developers find communities aligned with their interests. Categories include:
54+
55+
| **Category** | **Examples** |
56+
|-----------------------|-----------------------------------------------|
57+
| **Featured** | Editor’s choice for top Squads. |
58+
| **Languages** | JavaScript, Python, Rust. |
59+
| **Web** | React, Tailwind, Node.js. |
60+
| **Mobile** | Flutter, Swift, Kotlin. |
61+
| **DevOps & Cloud** | Kubernetes, AWS, Terraform. |
62+
| **AI** | OpenAI, TensorFlow, GPT Models. |
63+
| **Games** | Unity, Unreal Engine, Indie Game Design. |
64+
| **DevTools** | GitHub Actions, Postman, Sentry. |
65+
| **Career** | Leadership tips, job search, mentorship. |
66+
| **Open Source** | OSS maintainers, Git practices, contributions.|
67+
| **DevRel** | Community management, developer advocacy. |
68+
| **Fun** | Memes, programming jokes, off-topic topics. |
69+
70+
## Reporting Inappropriate Squads
71+
72+
To maintain a high-quality directory, we encourage users to report any inappropriate or non-compliant Squads. Reports are reviewed by the daily.dev moderation team, ensuring that only safe, high-value communities remain listed.
73+
74+
For any questions about the Squads Directory or how to improve your chances of being featured, feel free to contact us at [[email protected]](mailto:[email protected]).
75+
76+
By focusing on high-quality content and meaningful engagement, your Squad could become one of the standouts in the Squads Directory. 🚀

docs/squads/growing-your-squad.md

+22-6
Original file line numberDiff line numberDiff line change
@@ -57,13 +57,29 @@ Building your Squad starts with inviting other developers to join:
5757
Encourage members to invite peers who may be interested in your Squad’s topics to grow your community.
5858
:::
5959

60-
## Apply to Become a Public Squad
60+
## The New Squads Directory
6161

62-
As your Squad grows and gains activity, you might consider transitioning it to Public status to increase visibility and engagement within the daily.dev community:
62+
Public Squads are now automatically added to the [Squads Directory](https://app.daily.dev/squads), a curated space where developers can discover communities that align with their interests.
6363

64-
1. **Increased Exposure**: Public Squads are featured in the daily.dev feed, reaching a broader audience.
65-
2. **Community Building**: Public status enables you to connect with more developers and expand your community.
64+
### Categories in the Directory
6665

67-
For guidance on making your Squad public, including benefits, steps, and tips, refer to our [guide on becoming a Public Squad](/squads/public-squads.md). This guide will provide you with the information you need to successfully transition to Public status.
66+
When creating a Public Squad, you must select a category that fits your Squad's theme. Categories include:
67+
- **Featured**: Editor’s choice for top Squads on the platform.
68+
- **Languages**: Programming language-specific communities.
69+
- **Web, Mobile, DevOps & Cloud, AI, Games**: Development-focused categories.
70+
- **DevTools**: Squads by or for developer tools companies.
71+
- **Career**: Topics around career growth, leadership, and skills development.
72+
- **Open Source, DevRel, Fun**: Specialized communities for unique developer interests.
6873

69-
In the following pages, you’ll learn about tools for moderating your Squad, managing member roles, and adjusting privacy settings.
74+
### Tips for Gaining Visibility in the Directory
75+
76+
To improve your chances of being featured in the directory:
77+
1. **Optimize Your Metadata**: Add an engaging image, clear description, and select the most relevant category.
78+
2. **Grow Membership**: Invite members to join and participate actively.
79+
3. **Post Consistently**: Regular high-quality posts boost engagement and visibility.
80+
81+
## Building an Engaged Community
82+
83+
An active Squad is key to growth. By regularly posting, approving member contributions, and sparking discussions, your Squad can become a vibrant hub for developers.
84+
85+
Good luck with growing your Squad! 🚀

docs/squads/moderating-your-squad.md

+59-12
Original file line numberDiff line numberDiff line change
@@ -7,34 +7,81 @@ description: "Learn essential moderation tools and permissions management to eff
77

88
## Admin, Moderation, and Privacy Settings
99

10-
As a Squad admin, you have various tools and settings to help manage your Squad effectively. Here’s how to make the most of them.
10+
As a Squad admin, you have various tools and settings to help manage your Squad effectively. These tools enable you to foster a respectful and engaging environment for your members.
1111

1212
:::info
1313
Note: The tools described here are foundational for Squad management. We’re actively developing advanced moderation options to support even more effective community management.
1414
:::
1515

16-
## Deleting Posts, Comments, and Blocking Users
16+
## Key Moderation Features
1717

18-
As an admin, maintaining a respectful community is your responsibility:
19-
* **Deleting Posts or Comments**: To delete a post or comment that violates Squad guidelines, navigate to the post, click on the options menu, and select "Delete." Confirm in the pop-up window.
20-
* **Blocking Users**: For repeated guideline violations, you can block a member. Blocking removes them from the Squad and prevents rejoining. To reverse this action, unblock them manually by locating the user in the member list, choosing "Block" from their options, and confirming.
18+
**Post Approval**: Public Squads allow all members to post by default, but admins and moderators must approve posts before they go live. This ensures content aligns with your Squad’s code of conduct and quality expectations.
19+
20+
**Content Moderation**: Admins can delete posts and comments that violate guidelines to maintain a healthy discussion environment.
21+
22+
**User Management**: Block users who repeatedly violate guidelines, and reverse the action if necessary.
23+
24+
**Role Assignments**: Assign roles such as moderators or admins to trusted members to distribute management responsibilities.
25+
26+
**Reporting and Feedback**: Members can now report inappropriate Squads or posts. Reported content is reviewed by the daily.dev moderation team to maintain a safe and inclusive platform.
27+
28+
## Managing Posts
29+
30+
### Approving and Declining Posts
31+
32+
Public Squads have default settings where all members can post, but posts require admin or moderator approval.
33+
34+
1. **Approve or Decline Posts**: Review posts in the approval queue.
35+
2. **Decline with Feedback**: Provide a reason for declining posts to help the author improve.
36+
3. **Re-approval for Edits**: Posts must be re-approved after edits to prevent bypassing the moderation process.
37+
38+
### Deleting Posts and Comments
39+
40+
1. **Navigate to the Content**: Find the post or comment you need to delete.
41+
2. **Select "Delete"**: Use the options menu to remove the content permanently. Confirm the action in the pop-up window.
42+
43+
### Blocking Users
44+
45+
If a member repeatedly violates guidelines:
46+
1. **Find the User**: Locate the user in the member list.
47+
2. **Select "Block"**: This removes them from the Squad and prevents rejoining.
48+
3. **Unblock if Necessary**: You can reverse this action through the member list.
2149

2250
## Managing Permissions
2351

24-
* **Posting and Inviting**: Control who can post in the Squad and who can invite new members through the "Permissions" section in Squad settings.
25-
* **Group Guidelines**: Create a pinned welcome post outlining the group’s rules and expectations for easy access.
52+
Control member actions through the "Permissions" section in your Squad settings:
53+
- **Posting Permissions**: Decide who can post and whether post approval is required (default for Public Squads).
54+
- **Invitation Permissions**: By default, all members can invite others to join the Squad. Adjust this if needed.
55+
- **Group Guidelines**: Create a pinned welcome post outlining the rules and expectations for members.
2656

2757
## Member Roles
2858

2959
Squad members can have different roles with distinct permissions:
3060

31-
* **Member**: Can read and write posts, and add comments, as allowed by the permissions set.
32-
* **Moderator**: Has additional permissions to delete posts and comments and manage members following the rules set.
33-
* **Admin**: The admin, typically the Squad creator, can manage all posts, comments, members, and modify Squad settings, including privacy and permissions.
61+
- **Member**: Can read and write posts and comments, as allowed by permissions.
62+
- **Moderator**: Can manage posts, comments, and members following the rules set.
63+
- **Admin**: Full control over posts, comments, members, and Squad settings, including privacy and permissions.
3464

3565
### Managing Roles
3666

3767
![Promote to moderator cover image](https://daily-now-res.cloudinary.com/image/upload/v1690470250/docs/Update%20July%202023/promotomod.png)
3868

39-
* **Promoting to Moderator/Admin**: To promote a member, find them in the member list and select "Promote to Moderator" or "Make an Admin" from their options. They will then have access to moderation tools.
40-
* **Demoting Moderators**: If a moderator is not meeting their responsibilities, you can demote them back to a member by selecting "Demote to Member" in their options menu.
69+
1. **Promoting to Moderator or Admin**: Find a member in the list and select "Promote to Moderator" or "Make an Admin."
70+
2. **Demoting Moderators**: Demote a moderator back to a member if they fail to meet responsibilities by selecting "Demote to Member."
71+
72+
## Privacy Settings
73+
74+
Decide whether your Squad is Public or Private:
75+
- **Public Squads**: Open and discoverable in the Squads Directory.
76+
- **Private Squads**: Invite-only, with content visible only to members.
77+
78+
Public Squads must comply with daily.dev’s content guidelines to maintain their visibility.
79+
80+
## Tips for Effective Moderation
81+
82+
- Set clear rules and expectations in a pinned post.
83+
- Actively review and approve posts to maintain quality.
84+
- Assign trusted members as moderators to share the workload.
85+
- Regularly engage with members to foster a sense of community.
86+
87+
Effective moderation is key to growing a vibrant, respectful, and valuable Squad. 🚀

0 commit comments

Comments
 (0)