diff --git a/docs/community.md b/docs/community.md deleted file mode 100644 index 74e5b58a..00000000 --- a/docs/community.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -sidebar_position: 100 ---- -# 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. - -## Changelog -Stay up-to-date with the latest changes and updates on daily.dev by checking out our [changelog](https://app.daily.dev/squads/daily_updates) . - -## Twitter -Follow us on Twitter [@dailydotdev](https://twitter.com/dailydotdev) for the latest news, updates, educational content, giveaways, and engaging discussions related to daily.dev. - -## YouTube -Subscribe to our official [YouTube channel](https://www.youtube.com/c/dailydev) for a wealth of content, including Monthly Dev events with world-class talks, cool intro videos, tutorials, and more! Stay updated with new releases, educational content, giveaways, and behind-the-scenes glimpses. - -## LinkedIn -Connect with us on LinkedIn at [daily.dev](https://www.linkedin.com/company/dailydotdev) to stay in the loop with our latest updates, announcements, and educational content, as well as engage with our community. - -## TikTok -Join us on TikTok [@daily.dev](https://www.tiktok.com/@dailydotdev) for fun and engaging content related to daily.dev, including coding tips, behind-the-scenes glimpses, updates, and giveaways. - -## Instagram -In case you're into short-form videos make sure you don't miss our [Instagram profile](https://www.instagram.com/dailydotdev)! - -## Meetup -Join our meetup group to stay informed about our monthly events featuring inspiring talks from expert developers, and updates on new releases, educational content, and giveaways. [Join here](https://www.meetup.com/the-monthly-dev-world-class-talks-by-expert-developers/) - -## Feedback -Have feedback, questions, or feature requests? [Submit it here](https://daily.dev/feedback) and let us know how we can improve your daily.dev experience! diff --git a/docs/customize-your-feed/_category_.json b/docs/customize-your-feed/_category_.json index e1272008..7d6f0044 100644 --- a/docs/customize-your-feed/_category_.json +++ b/docs/customize-your-feed/_category_.json @@ -1,4 +1,4 @@ { "label": "Customization", - "position": 80 + "position": 100 } diff --git a/docs/for-content-creators/_category_.json b/docs/for-content-creators/_category_.json index e1330f2f..cf632c68 100644 --- a/docs/for-content-creators/_category_.json +++ b/docs/for-content-creators/_category_.json @@ -1,4 +1,4 @@ { "label": "For content creators", - "position": 90 + "position": 110 } diff --git a/docs/for-oss-contributors/_category_.json b/docs/for-oss-contributors/_category_.json deleted file mode 100644 index b7a56066..00000000 --- a/docs/for-oss-contributors/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "For OSS contributors", - "position": 100 -} diff --git a/docs/for-oss-contributors/how-to-contribute-to-daily-dev.md b/docs/for-oss-contributors/how-to-contribute-to-daily-dev.md deleted file mode 100644 index f7165c6e..00000000 --- a/docs/for-oss-contributors/how-to-contribute-to-daily-dev.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -sidebar_position: 1 -description: "Learn how to contribute to daily.dev’s open-source project, explore the GitHub repository, and set up locally with Docker." ---- - -# How to Contribute to daily.dev - -daily.dev is an **open-source project**, and we’re thrilled to welcome contributors! We believe in transparency and community collaboration, so we’ve published our source code on GitHub. You can suggest features, report bugs, or contribute code—everyone is welcome! - -## Why Open Source? - -Contributing to open source can be transformative for a developer’s career. Open source allows developers to build their portfolios, experiment with new technologies, and learn in public. Many leading companies and innovative startups are embracing open-source projects, making this a fantastic opportunity to learn, grow, and enhance your skills. - -## daily.dev’s GitHub Repository - -Explore our GitHub repository to level up your coding skills and contribute to daily.dev’s development: [daily.dev GitHub Repository](https://github.com/dailydotdev/daily). - -If you’re already visiting our GitHub repo, don’t forget to give us a star ⭐ to show your support! - -## Running daily.dev Locally with Docker - -Here’s a [video tutorial on running daily.dev locally with Docker](https://youtu.be/sNUpOJaL_B8) to help you get started quickly: - -[![Video tutorial for running daily.dev locally with Docker](https://daily-now-res.cloudinary.com/image/upload/v1636468644/docs/Running_daily.dev_locally_with_Docker.jpg)](https://youtu.be/sNUpOJaL_B8) diff --git a/docs/monetization/_category_.json b/docs/monetization/_category_.json index 2fe8fc2a..0089bd08 100644 --- a/docs/monetization/_category_.json +++ b/docs/monetization/_category_.json @@ -1,4 +1,4 @@ { "label": "Monetization (beta)", - "position": 70 + "position": 90 } diff --git a/docs/organizations/_category_.json b/docs/organizations/_category_.json new file mode 100644 index 00000000..8fd5a380 --- /dev/null +++ b/docs/organizations/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Organizations", + "position": 70 +} \ No newline at end of file diff --git a/docs/organizations/billing-management.md b/docs/organizations/billing-management.md new file mode 100644 index 00000000..a96060f8 --- /dev/null +++ b/docs/organizations/billing-management.md @@ -0,0 +1,142 @@ +--- +sidebar_position: 5 +description: "Organization owners' guide to billing management, seat allocation, subscription control, and cost optimization for daily.dev team Plus subscriptions." +--- + +# Billing and Seat Management + +Organization owners have full control over billing, subscription management, and seat allocation. This guide covers all aspects of managing your organization's Plus subscription. + +## Accessing Billing + +### For Organization Owners Only +Only organization owners can access billing features: + +1. **Navigate to Organizations**: Go to your profile menu and select "Organizations" +2. **Select Organization**: Click on your organization +3. **Billing Tab**: Navigate to the "Billing" section +4. **View Details**: See current subscription status and seat information + +## Current Billing Information + +### Subscription Overview +Your billing page displays: + +- **Current Plan**: Active Plus subscription details +- **Billing Cycle**: Monthly or annual billing frequency +- **Next Payment**: When your next payment is due +- **Total Seats**: Number of seats purchased +- **Assigned Seats**: How many seats are currently in use +- **Available Seats**: Remaining seats that can be assigned + +### Payment Information +- **Payment Method**: Current payment method on file +- **Billing History**: Previous payments and invoices +- **Subscription Status**: Active, canceled, or past due + +## Managing Seats + +### Adding Seats + +When you need more seats for your growing team: + +1. **Click "Manage Seats"**: Open the seat management modal +2. **Increase Quantity**: Select the new total number of seats needed +3. **Review Changes**: See the cost breakdown for additional seats +4. **Pay Now**: Complete payment for the additional seats +5. **Immediate Access**: New seats are available immediately after payment + +### Reducing Seats + +To reduce your seat count: + +1. **Check Usage**: Ensure assigned seats don't exceed the new total +2. **Remove Members First**: If needed, remove Plus from members to free up seats +3. **Open Manage Seats**: Click "Manage Seats" from the billing page +4. **Decrease Quantity**: Select the new lower seat count +5. **Confirm Changes**: Review the changes and confirm + +### Seat Management Rules + +#### Adding Seats +- **Immediate Billing**: You're charged immediately for additional seats +- **Prorated Charges**: New seats are prorated based on your billing cycle +- **Instant Availability**: New seats can be assigned to members immediately + +#### Reducing Seats +- **Usage Restriction**: Cannot reduce below currently assigned seats +- **Member Management**: Must remove Plus from members first if over new limit +- **Billing Adjustment**: Changes take effect on next billing cycle + +## Subscription Management + +### Modifying Your Plan +- **Cycle Changes**: Switch between monthly and annual billing +- **Plan Updates**: Modify subscription details through Paddle +- **Payment Methods**: Update credit cards and billing information + +### Cancellation Policy +- **Owner Only**: Only organization owners can cancel subscriptions +- **Member Impact**: All organization members lose Plus benefits upon cancellation +- **Billing End**: Service continues until the end of the current billing period +- **Data Retention**: Organization data is preserved but Plus features are disabled + +## Payment and Billing + +### Automatic Billing +- **Recurring Charges**: Subscriptions automatically renew based on your cycle +- **Payment Failures**: Failed payments result in suspension of Plus benefits +- **Retry Logic**: Payment retries occur automatically for failed transactions + +### Invoices and Receipts +- **Email Delivery**: Invoices are automatically emailed after payment +- **Download Access**: Access and download invoices from the billing page +- **Tax Information**: Invoices include applicable tax details + +## Billing Restrictions + +### Actions That Prevent Changes + +Certain actions are restricted when: + +#### Organization Deletion +- **Active Subscriptions**: Cannot delete organization with active Plus subscription +- **Assigned Seats**: Must remove all member Plus assignments first +- **Billing Resolution**: Cancel subscription before attempting to delete organization + +#### Seat Reduction +- **Over-Assigned**: Cannot reduce seats below currently assigned count +- **Member Management**: Must first remove Plus from excess members +- **Validation**: System prevents invalid seat reductions + +## Cost Management + +### Optimizing Costs +- **Regular Audits**: Review seat usage monthly +- **Remove Inactive**: Remove Plus from inactive team members +- **Right-Size**: Adjust seat count based on actual team size +- **Annual Savings**: Consider annual billing for cost savings + +### Usage Tracking +- **Member Activity**: Monitor which team members actively use Plus features +- **Seat Utilization**: Track percentage of seats actively used +- **Cost Per User**: Calculate effective cost per active user + +## Troubleshooting + +### Common Billing Issues + +#### Payment Failures +- **Update Payment Method**: Ensure credit card information is current +- **Billing Address**: Verify billing address matches payment method +- **Contact Support**: Reach out for persistent payment issues + +#### Seat Assignment Problems +- **Check Availability**: Ensure seats are available before assignment +- **Existing Plus**: Cannot override personal or other organization Plus subscriptions +- **Permission Issues**: Verify you have owner permissions for billing changes + +### Getting Help +- **Billing Support**: Contact support for billing-related questions +- **Documentation**: Refer to Plus documentation for feature questions +- **Account Issues**: Use the help center for account-related problems \ No newline at end of file diff --git a/docs/organizations/creating-organization.md b/docs/organizations/creating-organization.md new file mode 100644 index 00000000..03ba480c --- /dev/null +++ b/docs/organizations/creating-organization.md @@ -0,0 +1,67 @@ +--- +sidebar_position: 2 +description: "Step-by-step guide to creating an organization on daily.dev during Plus checkout or from your profile settings to manage team subscriptions." +--- + +# Creating an Organization + +Creating an organization on daily.dev allows you to manage Plus subscriptions for your entire team. You can create an organization during the Plus checkout process or from your profile settings. + +## Creating During Plus Checkout + +When purchasing Plus, you have the option to buy for your team instead of just yourself: + +1. **Navigate to Plus**: Go to the Plus page and click "Get Plus" +2. **Choose Team Option**: Select "Team" instead of "Personal" subscription +3. **Select Seats**: Choose the number of Plus seats you need for your team +4. **Organization Details**: Enter your organization name during checkout +5. **Complete Purchase**: Finish the payment process + +Your organization will be automatically created upon successful payment, and you'll become the owner with the first seat assigned to you. + +## Creating from Profile + +If you already have Plus or want to create an organization separately: + +1. **Access Profile Menu**: Click on your profile picture in the top navigation +2. **Select Organizations**: Choose "Organizations" from the dropdown menu +3. **Create New**: Click "Create Organization" if you're not a member of any organizations +4. **Organization Details**: + - Enter your organization name + - Optionally upload an organization image +5. **Save**: Click "Create" to establish your organization + +## Organization Setup + +After creating your organization, you'll need to: + +### Purchase Seats (if not done during checkout) +- Navigate to your organization's billing page +- Select the number of seats needed +- Complete the payment process + +### Customize Your Organization +- **Name**: Choose a clear, recognizable name for your team +- **Image**: Upload a logo or image to represent your organization +- **Settings**: Configure any additional preferences + +### Invite Team Members +- Get your organization's invite link from the members page +- Share the link with team members you want to add +- Team members can join by clicking the link (if seats are available) + +## Important Notes + +- **Owner Role**: The person who creates the organization automatically becomes the owner +- **Billing Responsibility**: The organization creator is responsible for the initial billing setup +- **Seat Management**: You can adjust the number of seats later through the billing page +- **Member Limits**: You can only assign Plus benefits up to the number of seats purchased + +## Next Steps + +After creating your organization: + +1. [Invite team members](inviting-members.md) +2. [Manage organization settings](managing-organization.md) +3. [Assign Plus benefits](managing-members.md) +4. [Handle billing and seats](billing-management.md) \ No newline at end of file diff --git a/docs/organizations/inviting-members.md b/docs/organizations/inviting-members.md new file mode 100644 index 00000000..794078db --- /dev/null +++ b/docs/organizations/inviting-members.md @@ -0,0 +1,138 @@ +--- +sidebar_position: 3 +description: "Learn how to invite team members to your daily.dev organization using unique invite links and manage seat availability for automatic Plus assignment." +--- + +# Inviting Members to Your Organization + +Organization admins and owners can invite team members to join their organization and receive Plus benefits. This guide covers the invitation process and best practices. + +## How Invitations Work + +### Invite Link System +Organizations use a unique invite link system: + +- **Unique Links**: Each organization has its own permanent invite link +- **Simple Sharing**: Share the link via email, Slack, or any communication method +- **Automatic Join**: Team members click the link to join instantly +- **Seat Assignment**: Plus benefits are assigned automatically if seats are available + +## Getting Your Invite Link + +### Accessing the Invite Link + +1. **Navigate to Members**: Go to your organization's members page +2. **Click "Invite Members"**: Open the invite modal +3. **Copy Link**: Copy the unique invite link for your organization +4. **Share**: Send the link to team members you want to invite + +### Invite Modal Features +- **Link Display**: Shows your organization's unique invite link +- **Copy Button**: One-click copying to clipboard +- **Seat Status**: Displays available seats for new members +- **QR Code**: Some interfaces may include QR codes for easy mobile sharing + +## Seat Availability + +### Before Inviting +Check your seat availability: + +- **Available Seats**: Ensure you have seats available for new members +- **Seat Limit**: You can only invite as many members as you have seats +- **Purchase More**: If needed, purchase additional seats before inviting + +### No Available Seats +If you're out of seats: + +- **Disabled Join**: The join button is disabled on the invite page +- **Clear Message**: Invited users see a message about seat availability +- **Manage Seats**: Use the "Manage Seats" button to purchase more seats + +## The Invitation Experience + +### For the Inviter (Admin/Owner) +1. **Get Link**: Copy the invite link from your organization +2. **Share Link**: Send to team members via your preferred method +3. **Track Joins**: Receive notifications when members join +4. **Monitor Seats**: Watch seat usage as members join + +### For the Invitee +1. **Receive Link**: Get the invite link from their admin/owner +2. **Click Link**: Navigate to the organization invite page +3. **Review Details**: See organization name, available seats, and join option +4. **Join Organization**: Click "Join" if seats are available +5. **Automatic Plus**: Receive Plus benefits immediately upon joining + +## Invitation Best Practices + +### Effective Communication +- **Context**: Explain what the organization is for and benefits of joining +- **Instructions**: Provide clear steps for joining +- **Benefits**: Highlight the Plus features they'll gain access to +- **Support**: Offer help if they have trouble joining + +### Timing Considerations +- **Seat Planning**: Ensure you have enough seats before mass invitations +- **Onboarding**: Consider sending invites in batches for better onboarding +- **Communication**: Time invites with team announcements or meetings + +## Managing Invitations + +### After Members Join +When someone joins your organization: + +- **Welcome Notification**: New members receive a welcome message +- **Admin Notification**: Admins and owners are notified of new joins +- **Email Confirmation**: Important joins may trigger email notifications +- **Plus Assignment**: Plus benefits are automatically assigned + +### Tracking New Members +- **Member List**: New members appear in your organization's member list +- **Role Assignment**: New members start as regular members +- **Activity Tracking**: Their activity becomes visible to admins/owners + +## Security and Access Control + +### Invite Link Security +- **Controlled Sharing**: Only share links with intended team members +- **No Expiration**: Links don't expire but can be regenerated if compromised +- **Organization Specific**: Links only work for the specific organization +- **Seat Protection**: Users can only join if seats are available + +### Managing Access +- **Member Review**: Regularly review who has joined your organization +- **Role Management**: Promote trusted members to admin as needed +- **Removal Process**: Remove members who no longer need access + +## Troubleshooting Invitations + +### Common Issues + +#### Link Not Working +- **Copy Correctly**: Ensure the full link is copied and shared +- **Access Method**: Try opening in a different browser or device +- **Account Status**: Ensure the invitee has a daily.dev account + +#### Cannot Join Organization +- **Seat Availability**: Check if seats are available +- **Existing Membership**: Users can't join if already a member +- **Plus Conflicts**: May not join if they have conflicting Plus subscriptions + +#### Missing Notifications +- **Check Settings**: Verify notification settings are enabled +- **Email Delivery**: Check spam folders for email notifications +- **Platform Notifications**: Ensure daily.dev notifications are enabled + +### Getting Help +- **Documentation**: Check member management documentation +- **Support**: Contact support for persistent invitation issues +- **Admin Assistance**: Work with other admins to troubleshoot problems + +## Next Steps + +After inviting members: + +1. [Manage member roles and permissions](managing-members.md) +2. [Monitor seat usage and billing](billing-management.md) +3. [Configure organization settings](managing-organization.md) +4. [Help members get started with Plus features](../plus/plus-overview.md) \ No newline at end of file diff --git a/docs/organizations/managing-members.md b/docs/organizations/managing-members.md new file mode 100644 index 00000000..8a5edd43 --- /dev/null +++ b/docs/organizations/managing-members.md @@ -0,0 +1,127 @@ +--- +sidebar_position: 4 +description: "Complete guide to managing organization members on daily.dev including role management, Plus assignment, member actions, and permission controls for owners and admins." +--- + +# Managing Organization Members + +As an organization owner or admin, you can manage team members, assign roles, and control Plus access. This guide covers all aspects of member management within your organization. + +## Viewing Members + +### For All Roles +All organization members can view the member list: + +1. **Navigate to Organizations**: Go to your profile menu and select "Organizations" +2. **Select Organization**: Click on your organization from the list +3. **View Members**: See all current members and their roles + +### Member Information Displayed +- **Profile Details**: Name, avatar, and profile information +- **Role**: Current role (Owner, Admin, or Member) +- **Plus Status**: Whether they have Plus through the organization +- **Activity Status**: Last activity (visible to admins and owners only) + +## Adding Members + +### Inviting New Members + +1. **Access Invite Link**: + - Navigate to your organization's members page + - Click "Invite Members" to open the invite modal + - Copy the unique invite link for your organization + +2. **Share the Link**: Send the invite link to team members via: + - Email + - Slack or other messaging platforms + - Direct sharing + +3. **Member Joins**: When someone clicks the link: + - They'll see the organization invite page + - They can join if seats are available + - Plus benefits are automatically assigned upon joining + +### Invite Link Features +- **Unique per Organization**: Each organization has its own invite link +- **Seat Availability**: Shows remaining seats when viewing the invite +- **Automatic Assignment**: Plus is assigned immediately if seats are available + +## Managing Member Roles + +### Available Actions (Admin/Owner) + +For each member, you can: + +#### View Profile +- Click on any member to view their full daily.dev profile +- Follow members directly from the member list + +#### Assign Plus Benefits +- **Upgrade to Plus**: Give Plus benefits using an available organization seat +- **Remove Plus**: Remove Plus benefits and free up a seat +- **Restrictions**: Cannot override personal Plus subscriptions or subscriptions from other organizations + +#### Promote Members +- **Admin to Admin**: Admins can promote regular members to admin status +- **Owner Privileges**: Only owners can promote members to admin or transfer ownership + +#### Remove Members +- **Admin Permissions**: Admins can remove regular members and other admins +- **Owner Permissions**: Owners can remove any member except themselves +- **Automatic Plus Removal**: Plus benefits are automatically removed when a member is removed + +### Role Promotion Rules + +| Current Role | Can Be Promoted By | Can Be Promoted To | +|--------------|-------------------|-------------------| +| Member | Admin or Owner | Admin | +| Admin | Owner only | Owner | +| Owner | Cannot be changed | - | + +## Member Actions Menu + +Access member actions by clicking the three-dot menu next to any member: + +### Available Options +- **View Profile**: Opens the member's daily.dev profile +- **Upgrade/Downgrade Plus**: Toggle Plus benefits (if seats available) +- **Promote to Admin**: Change member role to admin +- **Remove from Organization**: Remove the member entirely + +### Action Restrictions +- **Self-Management**: Admins and owners can upgrade/downgrade themselves +- **Existing Plus**: Cannot override personal Plus or Plus from other organizations +- **Owner Protection**: Owners cannot be removed or demoted + +## Member Activity Tracking + +### For Admins and Owners +- **Last Activity**: See when members were last active on daily.dev +- **Engagement Insights**: Understand how team members are using the platform +- **Seat Utilization**: Identify unused seats that could be reassigned + +## Notifications + +### Automatic Notifications Sent +- **Welcome**: New members receive a welcome notification +- **Plus Assignment**: Members are notified when Plus is assigned or removed +- **Role Changes**: Members are notified of role promotions +- **Removal**: Members are notified if removed from the organization + +### Admin/Owner Notifications +- **New Joins**: Admins and owners are notified when someone joins +- **Member Leaves**: Notification when a member leaves the organization +- **Email Updates**: Important changes are also sent via email + +## Best Practices + +### Effective Member Management +- **Regular Reviews**: Periodically review member list and activity +- **Role Distribution**: Have multiple admins to distribute management tasks +- **Seat Optimization**: Monitor seat usage and adjust as needed +- **Clear Communication**: Inform team members about role changes and expectations + +### Security Considerations +- **Invite Link Security**: Only share invite links with intended team members +- **Role Assignment**: Be thoughtful about admin promotions +- **Regular Audits**: Regularly review who has access to your organization \ No newline at end of file diff --git a/docs/organizations/managing-organization.md b/docs/organizations/managing-organization.md new file mode 100644 index 00000000..c59e3c03 --- /dev/null +++ b/docs/organizations/managing-organization.md @@ -0,0 +1,152 @@ +--- +sidebar_position: 6 +description: "Learn how to manage organization settings on daily.dev including name, image, branding, and organization deletion with proper permissions and access control." +--- + +# Managing Organization Settings + +Organization admins and owners can customize their organization's appearance and manage general settings. This guide covers all aspects of organization management and configuration. + +## Accessing Organization Settings + +### Permission Levels +- **Owners**: Full access to all settings including deletion +- **Admins**: Access to name, image, and general settings (no deletion) +- **Members**: View-only access to basic organization information + +### Navigation +1. **Profile Menu**: Click your profile picture in the top navigation +2. **Organizations**: Select "Organizations" from the dropdown +3. **Select Organization**: Click on your organization from the list +4. **Settings Tab**: Navigate to the "General Settings" section (admin/owner only) + +## Organization Information + +### Basic Details + +#### Organization Name +- **Current Name**: View and edit your organization's display name +- **Naming Guidelines**: Choose a clear, professional name that represents your team +- **Update Process**: Changes are saved immediately and visible to all members +- **Character Limits**: Names should be concise and professional + +#### Organization Image +- **Current Image**: View your organization's current logo or image +- **Upload New**: Click to upload a new image file +- **Image Requirements**: + - Supported formats: PNG, JPG, GIF + - Recommended size: Square aspect ratio (e.g., 200x200px) + - File size limit: Under 2MB for optimal performance +- **Fallback**: If no image is set, a default placeholder is displayed + +### Display and Branding +- **Consistency**: Ensure your organization name and image match your company branding +- **Recognition**: Use images and names that team members will easily recognize +- **Professionalism**: Maintain appropriate branding for business use + +## Organization Management + +### Settings Available to Admins and Owners + +#### General Configuration +- **Organization Details**: Update name and image as needed +- **Member Visibility**: Control how organization information is displayed +- **Branding Consistency**: Maintain consistent visual identity + +### Owner-Exclusive Settings + +#### Organization Deletion +- **Access**: Only organization owners can delete organizations +- **Requirements**: Organization can only be deleted if: + - No active Plus subscription + - No assigned seats to members + - All members have been removed or Plus has been unassigned +- **Process**: + 1. Cancel active subscriptions + 2. Remove Plus from all members + 3. Confirm deletion in settings + 4. All organization data is permanently removed + +#### Advanced Management +- **Billing Integration**: Owner settings integrate with billing management +- **Security Controls**: Owners have ultimate control over organization security +- **Data Management**: Owners are responsible for data retention and deletion + +## Member View + +### What Regular Members Can See +Regular organization members have access to: + +- **Organization Name**: Current organization name and branding +- **Organization Image**: Logo or image representing the organization +- **Member List**: View all organization members and their roles +- **Member Profiles**: Access to other members' daily.dev profiles +- **Follow Functionality**: Ability to follow other organization members + +### Limited Access +Members cannot: +- Change organization settings +- Modify organization name or image +- Access billing information +- Manage other members +- Delete the organization + +## Organization Overview Page + +### For Non-Members +Users who aren't part of any organization see: +- **Create Organization**: Option to create a new organization +- **Personal Invite**: Pre-filled personal invite information +- **Getting Started**: Guidance on setting up their first organization + +### For Existing Members +Users who belong to organizations see: +- **Organization List**: All organizations they're members of +- **Role Indicators**: Their role in each organization +- **Quick Access**: Direct links to each organization's member area +- **Organization Details**: Name, image, and member count for each + +## Best Practices + +### Organization Setup +- **Clear Naming**: Use names that clearly identify your company or team +- **Professional Images**: Upload high-quality logos or professional images +- **Regular Updates**: Keep organization information current and accurate +- **Consistent Branding**: Align with your company's visual identity + +### Management Guidelines +- **Regular Reviews**: Periodically review organization settings and information +- **Image Quality**: Ensure images remain clear and professional +- **Access Control**: Be mindful of who has admin and owner permissions +- **Documentation**: Keep internal records of organization changes + +## Troubleshooting + +### Common Issues + +#### Cannot Update Settings +- **Permission Check**: Verify you have admin or owner permissions +- **Browser Issues**: Try refreshing the page or using a different browser +- **Network Problems**: Check your internet connection + +#### Image Upload Problems +- **File Size**: Ensure image is under 2MB +- **File Format**: Use PNG, JPG, or GIF formats +- **Browser Compatibility**: Try a different browser if uploads fail + +#### Deletion Restrictions +- **Active Subscriptions**: Cancel all subscriptions before deletion +- **Assigned Seats**: Remove Plus from all members first +- **Permission Level**: Only owners can delete organizations + +### Getting Help +- **Documentation**: Refer to related documentation for specific features +- **Support**: Contact support for technical issues +- **Admin Assistance**: Work with other admins for management questions + +## Related Topics + +- [Creating an Organization](creating-organization.md) +- [Managing Members](managing-members.md) +- [Billing Management](billing-management.md) +- [Inviting Members](inviting-members.md) \ No newline at end of file diff --git a/docs/organizations/overview.md b/docs/organizations/overview.md new file mode 100644 index 00000000..a52d4adc --- /dev/null +++ b/docs/organizations/overview.md @@ -0,0 +1,66 @@ +--- +sidebar_position: 1 +description: "Learn about Organizations on daily.dev - team accounts that allow companies to purchase and manage multiple Plus subscriptions centrally with role-based access control." +--- + +# Organizations Overview + +Organizations on daily.dev allow companies and teams to purchase and manage multiple Plus subscriptions for their members. This feature enables centralized management of Plus benefits, making it easier for teams to access premium features together. + +## What are Organizations? + +Organizations are team accounts that allow companies to: + +- Purchase Plus subscriptions in bulk for their team members +- Centrally manage member access and permissions +- Assign and reassign Plus seats as needed +- Control billing and subscription management from one place + +## Key Benefits + +- **Centralized Management**: Admins can manage all team members' Plus subscriptions from one dashboard +- **Flexible Seat Management**: Add or remove seats as your team grows or changes +- **Role-Based Access**: Different permission levels for owners, admins, and members +- **Simplified Billing**: One subscription covers multiple team members +- **Easy Onboarding**: Invite team members with a simple invite link + +## Getting Started + +To get started with Organizations: + +1. **Create an Organization**: Set up your team account during Plus checkout or from your profile +2. **Purchase Seats**: Buy the number of Plus seats you need for your team +3. **Invite Members**: Share your organization's invite link with team members +4. **Manage Access**: Assign Plus benefits and manage member roles as needed + +## Organization Roles + +Organizations have three distinct roles with different permissions: + +### Owner +- **Full Control**: Complete access to all organization settings +- **Billing Management**: Can modify subscriptions and manage seats +- **Member Management**: Can add, remove, and promote members +- **Settings**: Can update organization name, image, and delete the organization +- **Unique Role**: Only one owner per organization + +### Admin +- **Member Management**: Can invite, remove, and promote members +- **Plus Assignment**: Can assign or remove Plus benefits from members +- **Settings**: Can update organization name and image +- **No Billing Access**: Cannot modify subscriptions or billing + +### Member +- **View Access**: Can see other organization members +- **Follow Members**: Can follow other team members +- **Limited Permissions**: Cannot manage other members or organization settings + +## How It Works + +1. **Purchase**: Choose team checkout when buying Plus and select the number of seats needed +2. **Setup**: Create your organization with a name and optional image +3. **Invite**: Share the invite link with team members you want to add +4. **Assign**: Team members automatically receive Plus benefits when they join (if seats are available) +5. **Manage**: Owners and admins can adjust seats, manage members, and update settings as needed + +Organizations make it simple for teams to share the benefits of daily.dev Plus while maintaining control over access and billing. \ No newline at end of file diff --git a/docs/plus/plus-overview.md b/docs/plus/plus-overview.md index 56c703a1..0345561e 100644 --- a/docs/plus/plus-overview.md +++ b/docs/plus/plus-overview.md @@ -79,6 +79,17 @@ Read in your preferred language with automatic translations for post titles and - Discover new sources without limitations - Stay informed no matter the language +## Team Subscriptions + +Need Plus for your entire team? Organizations allow companies to purchase and manage multiple Plus subscriptions centrally: + +- **Bulk Purchasing**: Buy Plus seats for your whole team +- **Centralized Management**: Admins can assign and manage Plus benefits +- **Flexible Scaling**: Add or remove seats as your team grows +- **Role-Based Access**: Owners, admins, and members with different permissions + +👉 [Learn about Organizations](../organizations/overview.md) + ## Still not on Plus? daily.dev Plus gives you more control, clarity, and customization—so you can focus on what truly matters. diff --git a/src/components/homepage/homeNavBoxes.js b/src/components/homepage/homeNavBoxes.js index f83f21bc..cc342335 100644 --- a/src/components/homepage/homeNavBoxes.js +++ b/src/components/homepage/homeNavBoxes.js @@ -101,6 +101,18 @@ const FeatureList = [ { url: 'docs/plus/keyword-filters', text: 'Keyword Filters' }, ], }, + { + title: 'Organizations', + icon: 'img/icons/organizations.svg', + items: [ + { url: 'docs/organizations/overview', text: 'Overview' }, + { url: 'docs/organizations/creating-organization', text: 'Creating an Organization' }, + { url: 'docs/organizations/inviting-members', text: 'Inviting Members' }, + { url: 'docs/organizations/managing-members', text: 'Managing Members' }, + { url: 'docs/organizations/billing-management', text: 'Billing & Seats' }, + { url: 'docs/organizations/managing-organization', text: 'Organization Settings' }, + ], + }, { title: 'Monetization (beta)', icon: 'img/icons/cores.svg', @@ -142,16 +154,6 @@ const FeatureList = [ }, ], }, - { - title: 'For OSS contributors', - icon: 'img/icons/oss-contributors.svg', - items: [ - { - url: 'docs/for-oss-contributors/how-to-contribute-to-daily-dev', - text: 'How to contribute to daily.dev', - }, - ], - }, ]; function FeatureItem({ url, text }) { @@ -172,10 +174,10 @@ function Feature({ title, icon, items }) { 'Your profile': 'Manage your profile settings and activity', Squads: 'Join and manage developer community squads', Plus: 'Discover premium features and subscriptions', + Organizations: 'Manage team subscriptions and organization settings', 'Monetization (beta)': 'Learn about monetization and earning features', Customization: 'Personalize your daily.dev experience', 'For content creators': 'Resources for content creators and publishers', - 'For OSS contributors': 'Open source contribution guidelines and resources', }; return ( diff --git a/src/css/custom.css b/src/css/custom.css index d19d8c3a..06769f3c 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -642,32 +642,20 @@ html[data-theme='light'] .menu__link:before { background: url('../img/menu/plus.svg'); } .theme-doc-sidebar-menu li:nth-child(8) .menu__link:before { - background: url('../img/menu/cores.svg'); + background: url('../img/menu/organizations.svg'); } .theme-doc-sidebar-menu li:nth-child(9) .menu__link:before { - background: url('../img/menu/customization.svg'); + background: url('../img/menu/cores.svg'); } .theme-doc-sidebar-menu li:nth-child(10) .menu__link:before { - background: url('../img/menu/useful-guides.svg'); + background: url('../img/menu/customization.svg'); } .theme-doc-sidebar-menu li:nth-child(11) .menu__link:before { background: url('../img/menu/content-creator.svg'); } -.theme-doc-sidebar-menu li:nth-child(12) .menu__link:before { - background: url('../img/menu/oss-contributors.svg'); -} -.theme-doc-sidebar-menu li:nth-child(13) .menu__link:before { - background: url('../img/menu/community.svg'); -} - -.theme-doc-sidebar-menu li:nth-child(13) .menu__link { - position: relative; - margin-left: 0rem; - padding-left: 2.3rem; -} .theme-doc-sidebar-item-link-level-2 > .menu__link:before { background: none !important; diff --git a/src/img/menu/organizations.svg b/src/img/menu/organizations.svg new file mode 100644 index 00000000..bc8b4a5f --- /dev/null +++ b/src/img/menu/organizations.svg @@ -0,0 +1,8 @@ + +Organizations and team management icon for daily.dev + + + + + + \ No newline at end of file diff --git a/static/img/icons/organizations.svg b/static/img/icons/organizations.svg new file mode 100644 index 00000000..bc8b4a5f --- /dev/null +++ b/static/img/icons/organizations.svg @@ -0,0 +1,8 @@ + +Organizations and team management icon for daily.dev + + + + + + \ No newline at end of file diff --git a/static/manifest.json b/static/manifest.json index 4d729a77..683b45b6 100644 --- a/static/manifest.json +++ b/static/manifest.json @@ -153,18 +153,6 @@ "sizes": "96x96" } ] - }, - { - "name": "Community", - "short_name": "Community", - "description": "Join the daily.dev community", - "url": "/docs/community", - "icons": [ - { - "src": "/img/menu/community.svg", - "sizes": "96x96" - } - ] } ], "related_applications": [