add squads section to the docs

add squads icon on the sidebar

Author: nimrodkra

docs/community.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 100
+sidebar_position: 110
 ---
 # Community
 Welcome to the daily.dev community! Join us on our various social media channels to stay updated with the latest news, events, educational content, giveaways, and more related to daily.dev.

docs/customize-your-feed/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Customization",
-  "position": 50
+  "position": 60
 }

docs/for-content-creators/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "For content creators",
-  "position": 80
+  "position": 90
 }

docs/for-oss-contributors/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "For OSS contributors",
-  "position": 90
+  "position": 100
 }

docs/how-does-daily-dev-work/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Useful guides",
-  "position": 60
+  "position": 70
 }

docs/integrations/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Integrations",
-  "position": 70
+  "position": 80
 }

docs/squads/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "✨New✨ Squads",
+  "position": 50
+}

docs/squads/creating-your-squad.md

@@ -0,0 +1,35 @@
+---
+sidebar_position: 0
+---
+
+# Overview and Creating Your Squad
+![A cover image for squads](https://daily-now-res.cloudinary.com/image/upload/v1690467943/docs/Update%20July%202023/-_Private_squads_v3_2.png)
+## What is a Squad?
+
+In daily.dev, a Squad is a group where developers can come together to learn and interact on topics that matter to them. You can think of Squads as your own personalized Facebook Group, but geared specifically towards developers. Here, you can share knowledge, ask questions, and engage in lively discussions, all within a community of your peers.
+
+Squads can be centered around specific coding languages, certain software practices, industry trends, or any topic of your choosing. The possibilities are endless.
+
+## Benefits of a Squad
+
+By creating or joining a Squad, you can:
+* Network with other developers who share your interests
+* Share and discuss the latest articles or posts from daily.dev feed or other sources
+* Gain insights and new perspectives from community discussions
+* Foster a collaborative learning environment
+
+## How to Create a Squad
+
+Creating a new Squad is simple and straightforward. Follow these steps to get started:
+
+1. **Start a new Squad**: On your left sidebar, find and click the "Create Squad" button.
+2. **Name your Squad**: Choose a name and handle that represents the theme or focus of your Squad.
+3. **Add an Image**: You can choose to upload an image that will serve as the cover photo for your Squad. This could be a logo, an icon, or any image related to your Squad's topic.
+4. **Write a Description**: Describe what your Squad is about. This is a great place to detail the main topic, what members can expect, and why they should join.
+
+:::tip
+Remember, the most vibrant Squads are those with active participation. Encourage your members to contribute, share their knowledge, and engage in discussions. With your leadership and the tools provided by daily.dev, your Squad is well on its way to becoming a dynamic and valuable community for developers.
+:::
+
+Congratulations! You've created your first Squad. In the following pages, you'll learn how to invite other developers, 
+manage posts and discussions, and use various admin and moderation tools to help your Squad thrive.

docs/squads/growing-your-squad.md

@@ -0,0 +1,58 @@
+---
+sidebar_position: 1
+---
+
+# Growing Your Squad
+
+## Inviting Others to Your Squad
+
+Now that you've created your Squad, it's time to build and grow it. Inviting other developers to join your Squad is a straightforward process:
+
+1. **Access Your Squad**: Navigate to your Squad from the left sidebar.
+2. **Invite Developers**: Click on the "Copy invitation link" button to copy your personal invitation link to your clipboard.
+3. **Send Invitations**: use your personal invitation link and send it via email, your favorite messaging app or post it on social media.
+
+:::info
+Remember, the growth of your Squad depends on the active participation of its members. Encourage your members to invite their peers who may be interested in the topics you're discussing.
+:::
+
+## Managing Posts
+
+In a Squad, posts form the backbone of discussion and engagement. They are where you and your members can share valuable content and start meaningful discussions.
+
+## Creating a Post
+
+1. **Create a New Post**: Inside your Squad, click on the "New Post" button.
+2. **Add Content**: You can write a post from scratch or share links from the daily.dev feed or external sources. Add a title and description for the content to provide context to your members.
+3. **Post**: Click "Post" to share your content with the Squad.
+
+:::tip
+Both posts and comments have full markdown support so you can format it, add code snippets, and more.
+:::
+
+
+## Sharing Posts from the Feed
+
+Sharing interesting posts from the daily.dev feed to your Squad is a great way to foster discussions:
+
+1. Navigate to the daily.dev feed
+2. Find a post you'd like to share with your Squad
+3. Click on the "Share" icon
+4. Choose the Squad you want to share the post with
+5. Add your commentary and hit "Post"
+
+:::Tip 
+We also have a 1-click-share feature. When you're on the post page, you'll see all the Squads you're part of on the right side of the page. Simply click on the Squad icon to share the post to that Squad.
+:::
+
+## Commenting on a Post
+
+Engage with posts by adding comments:
+
+1. **Select a Post**: Click on a post that you want to comment on.
+2. **Write a Comment**: At the bottom of the post, you'll find a comment box. Write your thoughts, questions, or any input you want to share.
+3. **Post Your Comment**: Click "Post Comment" to add your comment to the discussion.
+
+By regularly creating posts and engaging in discussions, you can foster an active and dynamic community in your Squad.
+
+In the following pages, you will learn about the tools available for moderating your Squad, managing member roles, and adjusting privacy settings. Stay tuned!

docs/squads/managing-your-squad.md

@@ -0,0 +1,43 @@
+---
+sidebar_position: 2
+---
+
+# Managing Your Squad
+
+## Admin, Moderation, and Privacy Settings
+
+In your role as a Squad admin, you have a wide range of tools and settings to help manage your Squad. This guide will help you understand these options and how to use them effectively.
+
+:::info
+Note: The provided tools are the most basic ones to get you started with your Squad management. We understand the criticality of robust and comprehensive moderation tools for the success of Squads. Rest assured, we're actively working to add more advanced moderation options and enhancements to this toolkit.
+:::
+
+## Deleting Posts, Comments, and Removing Users
+As an admin, maintaining a respectful community is in your hands:
+* **Deleting Posts or Comments**: If a post or comment violates the Squad guidelines, navigate to it, click on the options menu, and select "Delete". Confirm in the pop-up window.
+* **Removing Users**: Should a member consistently breach guidelines, you can remove them. Find the user in the member list, select "Remove" from their options menu, and confirm your decision.
+
+## Managing Permissions
+
+* **Posting and Inviting**: You control who can post in the Squad and who can invite new members. These settings are available under the "Permissions" section in your Squad settings.
+* **Group Guidelines**: Create a welcome post outlining the group's rules and expectations. Pin it to the top of your Squad feed for easy accessibility.
+
+## Member Roles
+
+Your Squad members can have different roles, each with distinct permissions:
+
+* **Member**: Can read and write posts, and add comments, based on the permissions you set.
+* **Moderator**: In addition to member permissions, can delete posts, delete comments, and manage members in line with the rules you set.
+* **Admin**: The admin, usually the Squad creator, can manage all posts, comments, members, and modify Squad settings, including privacy settings and permissions.
+
+### Managing Roles
+* **Promoting to Moderator/Admin**: Find the member you wish to promote in the member list, select "Promote to Moderator" or "Make an Admin" from their options menu. They will now have access to moderation tools.
+* **Demoting Moderators**: If a moderator isn't fulfilling their duties, demote them back to a member by selecting "Demote to Member" in their options menu.
+
+## Squad Privacy Settings
+You can choose the visibility of your Squad:
+
+1. **Private Squads**: Only members can view and contribute to the Squad content. You control invitations.
+2. **Public Squads** (in closed beta): Open to all daily.dev users. Currently, public Squads are in early beta with a waitlist for public Squad creation.
+
+By understanding and utilizing these tools and settings effectively, you can shape your Squad into a vibrant, engaging, and respectful community.