dailydotdev · nimrodkra · Jul 21, 2025
diff --git a/docs/community.md b/docs/community.md
@@ -1,29 +1,41 @@
 ---
 sidebar_position: 100
+description: "Connect with the daily.dev developer community across social platforms, events, and feedback channels. Stay updated with the latest product news and join discussions."
 ---
+
 # 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) .
+Connect with thousands of developers in the daily.dev community! Follow us across multiple channels for product updates, educational content, developer events, and engaging discussions.
+
+:::tip
+The best way to engage with our community is through [Squads](squads/creating-your-squad.md) on daily.dev itself. Join existing developer communities or create your own around the topics you care about most.
+:::
+
+## Official Channels
+
+### Product Updates
+Stay current with platform changes and new features:
+- **[Changelog](https://app.daily.dev/squads/daily_updates)** - Real-time product updates and feature releases
+- **[Feedback Portal](https://daily.dev/feedback)** - Submit feature requests, bug reports, and suggestions
 
-## 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.
+### Social Media
+Follow us for news, developer content, and community highlights:
 
-## 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.
+- **[Twitter (@dailydotdev)](https://twitter.com/dailydotdev)** - Product announcements, developer tips, and community discussions
+- **[LinkedIn](https://www.linkedin.com/company/dailydotdev)** - Professional updates and company news
+- **[TikTok (@daily.dev)](https://www.tiktok.com/@dailydotdev)** - Quick coding tips and behind-the-scenes content
+- **[Instagram](https://www.instagram.com/dailydotdev)** - Visual content and platform highlights
 
-## 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.
+### Video Content
+Learn and grow with our educational content:
 
-## 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.
+- **[YouTube Channel](https://www.youtube.com/c/dailydev)** - Monthly Dev events featuring world-class talks from expert developers, tutorials, and product demos
 
-## Instagram
-In case you're into short-form videos make sure you don't miss our [Instagram profile](https://www.instagram.com/dailydotdev)! 
+### Events
+Join live developer events and networking opportunities:
 
-## 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/)
+- **[Monthly Dev Meetup](https://www.meetup.com/the-monthly-dev-world-class-talks-by-expert-developers/)** - Regular meetups with inspiring talks from 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!
+:::info
+Have questions or need support? Our community is here to help. Reach out through our [feedback portal](https://daily.dev/feedback) for direct assistance.
+:::
diff --git a/docs/customize-your-feed/density.md b/docs/customize-your-feed/density.md
@@ -1,32 +1,52 @@
 ---
 sidebar_position: 2
-description: "Learn how to adjust content density on the daily.dev feed with Eco, Roomy, and Cozy settings for a personalized reading experience."
+description: "Optimize your feed's content density with three professional layouts: Eco for maximum content, Roomy for balanced reading, and Cozy for immersive browsing."
 ---
 
-# Density Settings
+# Feed Density Settings
 
-The density option enables you to set the density of content on the **daily.dev feed**. Choose from **Eco**, **Roomy**, and **Cozy** options to personalize your reading experience.
+Customize how much content appears on your screen with three carefully designed density options. Each setting optimizes your reading experience for different preferences and screen sizes.
 
-## Eco Density Setting
+:::tip Choose Your Perfect Density
+Eco maximizes content visibility, Roomy provides balanced spacing, and Cozy offers an immersive reading experience.
+:::
+
+## Eco Density - Maximum Content
+
+Eco density maximizes the number of articles visible on your screen, perfect for power users who want to scan through more content quickly.
 
 ![Eco density setting preview on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400282/docs-v2/3bb874f9-c920-4717-b606-07c697f431a0.png)
 
-Set the density of your feed to Eco, as shown below:
+**To enable Eco density:**
 
 ![How to set Eco density from menu on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400351/docs-v2/245139c1-9435-4433-aae6-779461ea8c50.png)
 
-## Roomy Density Setting
+**Best for:** Developers who prefer scanning multiple articles at once, smaller screens, or high-speed content consumption.
+
+## Roomy Density - Balanced Layout
+
+Roomy density strikes the perfect balance between content visibility and readability, offering comfortable spacing without sacrificing efficiency.
 
 ![Roomy density setting preview on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400462/docs-v2/bea54acf-ecf4-4c9a-93d0-1962c8694706.png)
 
-Set the density of your feed to Roomy, as shown below:
+**To enable Roomy density:**
 
 ![How to set Roomy density from menu on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400407/docs-v2/928ceb27-1a44-43a2-9c56-245d43e29ac1.png)
 
-## Cozy Density Setting
+**Best for:** Most users seeking an optimal balance between content density and comfortable reading.
+
+## Cozy Density - Immersive Reading
+
+Cozy density provides generous spacing and larger content cards for a relaxed, immersive reading experience with enhanced visual comfort.
 
 ![Cozy density setting preview on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400566/docs-v2/3eb0e893-cb8a-48c5-9543-c29179a8fcd3.png)
 
-Set the density of your feed to Cozy, as shown below:
+**To enable Cozy density:**
 
 ![How to set Cozy density from menu on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400531/docs-v2/c90ae104-6c65-4e70-aac3-caaf06bba48d.png)
+
+**Best for:** Leisurely browsing sessions, large screens, or users who prefer focus on individual articles.
+
+:::info Quick Access
+All density settings are instantly accessible through the customize menu in your top-right profile dropdown.
+:::
diff --git a/docs/customize-your-feed/layout.md b/docs/customize-your-feed/layout.md
@@ -1,28 +1,44 @@
 ---
 sidebar_position: 0
-description: "Customize your daily.dev feed layout with Grid and List modes for an optimal reading experience across all devices."
+description: "Switch between Grid and List layouts to optimize your content consumption. Choose the perfect viewing mode for your screen size and reading style."
 ---
 
-# Layout Options 
+# Feed Layout Options
 
-The layout option lets you select how posts are displayed on your **daily.dev feed**. Switch between **Grid mode** and **List mode** to suit your viewing preferences.
+Choose how your content is displayed with two powerful layout modes designed for different reading preferences and device types.
 
-To switch between Grid and List mode, click on the **customize** option from the top-right profile menu, as shown below:
+:::tip Layout Quick Switch
+Toggle between Grid and List modes instantly through the customize option in your top-right profile menu.
+:::
+
+**To switch layouts:**
 
 ![Switch from List to Grid mode on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724400818/docs-v2/a57d8ba8-dbfb-4407-9759-fbf9dc1154a6.png)
 
-## Grid Mode for Content Display
+## Grid Mode - Visual Content Discovery
 
-The **Grid mode** displays posts as cards arranged in a grid format, as seen in the image below:
+Grid mode displays articles as visually rich cards in a responsive grid layout, maximizing content discovery and visual engagement.
 
 ![Grid mode view for daily.dev feed](https://daily-now-res.cloudinary.com/image/upload/v1724400852/docs-v2/a6b59df0-78b5-431a-8719-1efb654f9ef4.png)
 
-In Grid mode, posts are positioned both vertically and horizontally, making it easy to scan and interact with the content. Grid mode adapts seamlessly to various viewports and orientations, providing consistency across different platforms and screen sizes.
+**Grid mode benefits:**
+- **Visual browsing** - Rich previews with cover images and source branding
+- **Responsive design** - Adapts seamlessly to any screen size or orientation
+- **Quick scanning** - Efficiently browse multiple articles simultaneously
+- **Enhanced engagement** - Visual cues help identify interesting content faster
 
-## List Mode for Simplified Layout
+## List Mode - Streamlined Reading
 
-In **List mode**, posts are stacked vertically in a list, as shown below:
+List mode presents articles in a clean, vertical stack that prioritizes text content and reading efficiency over visual elements.
 
 ![List mode view for daily.dev feed](https://daily-now-res.cloudinary.com/image/upload/v1724400878/docs-v2/5ff46522-dfc3-401b-9aff-12819a91f4c4.png)
 
-List mode displays posts in a simple, stacked format, showing only source images without cover images. This option is ideal if you prefer a shorter feed with fewer visuals.
+**List mode benefits:**
+- **Text-focused** - Emphasizes titles and metadata for faster content assessment
+- **Performance optimized** - Faster loading with minimal visual elements
+- **Familiar format** - Traditional list layout similar to news aggregators
+- **Data efficient** - Uses less bandwidth by loading fewer images
+
+:::info Choosing Your Layout
+**Grid mode** is perfect for visual learners and content discovery, while **List mode** excels for focused reading and bandwidth conservation.
+:::
diff --git a/docs/customize-your-feed/preferences.md b/docs/customize-your-feed/preferences.md
@@ -1,53 +1,105 @@
 ---
 sidebar_position: 3
-description: "Customize your daily.dev experience with preferences like reading streaks, link behavior, and companion widget for a personalized feed."
+description: "Fine-tune your daily.dev experience with customizable preferences for reading behavior, interface elements, and accessibility features."
 ---
 
-# Preferences Settings
+# Preferences & Customization
 
 !["Preferences"](https://daily-now-res.cloudinary.com/image/upload/v1724399519/docs-v2/699dcb1d-8bcc-481f-8ef3-3f2cbc80b15f.png)
 
-The preferences options allow you to fine-tune your **daily.dev** experience by toggling various features on or off. Currently, available options include:
+Personalize your daily.dev experience with powerful preference controls that adapt the platform to your workflow and reading style.
 
-- Show reading streaks
-- Open links in a new tab
-- Show custom shortcuts
-- Show feed sorting menu
-- Enable companion
+:::tip Instant Customization
+All preference changes take effect immediately - no need to save or reload the page.
+:::
 
-### Accessibility
-- Automatically dismiss notifications
+## Available Preferences
 
-## Show Reading Streaks
+**Interface & Navigation:**
+- 🔥 Show reading streaks
+- 🔗 Open links in a new tab
+- ⚡ Show custom shortcuts
+- 🗒️ Show feed sorting menu
+- 🤝 Enable companion widget
 
-By default, daily.dev displays your reading streaks in the top right corner of your feed. If you’d prefer to hide your reading streaks, set the `Show reading streaks` toggle switch to `off`.
+**Accessibility:**
+- 🔔 Automatically dismiss notifications
 
-## Open Links in a New Tab
+## 🔥 Reading Streaks Display
 
-When you click a post link on your feed using the `Read post` button, daily.dev will open that post in a new tab by default. To have posts open in the current tab instead, set the `Open links in new tab` toggle switch to `off`.
+Reading streaks appear in the top-right corner of your feed, tracking your consistent daily engagement with developer content.
 
-## Show Custom Shortcuts
+**To hide reading streaks:** Toggle the `Show reading streaks` setting to `off`.
 
-Enable this option to access custom shortcuts at the top center of your feed.
+:::info Motivation Through Gamification
+Reading streaks encourage consistent learning habits and help track your professional development progress.
+:::
+
+## 🔗 Link Opening Behavior
+
+Control how articles open when you click the "Read post" button - either in a new tab (default) or the current tab.
+
+**Default behavior:** Articles open in new tabs, preserving your feed position  
+**Alternative:** Toggle off to open articles in the current tab
+
+:::tip Developer Workflow
+New tabs are recommended for maintaining your browsing context while diving deep into technical articles.
+:::
+
+## ⚡ Custom Shortcuts
+
+Activate quick-access shortcuts positioned at the top center of your feed for instant navigation to your most-used features.
 
 ![Enable custom shortcuts on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724399755/docs-v2/dfd3d9aa-1cec-4d0d-b340-0913c8b9ea6b.png)
 
-## Show Feed Sorting Menu
+**Benefits:**
+- Faster access to frequently used features
+- Customizable based on your workflow
+- Reduces navigation time
 
-Turning this toggle switch on adds a dropdown menu to the My Feed and Popular Feed sections, enabling sorting by `Date` or by `Recommended`, as shown below:
+## 🗂️ Feed Sorting Controls
+
+Enable sorting options for both My Feed and Popular Feed sections, allowing you to organize content by Date or Recommended algorithms.
 
 ![Feed sorting menu on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1724399859/docs-v2/ea9b06cd-b59c-4ccb-a420-cda7bba7e75e.png)
 
-## Enable Companion Widget
+**Sorting options:**
+- **Date:** Latest articles first (chronological)
+- **Recommended:** Algorithm-optimized content based on your interests
+
+## 🤝 Companion Widget
 
-Switching this toggle to `on` activates the [companion widget for daily.dev](https://docs.daily.dev/docs/key-features/the-companion), while setting it to `off` deactivates the widget.
+The companion widget brings daily.dev functionality directly to the original article pages, enabling seamless interaction without leaving the source content.
 
-The companion widget enhances your experience by allowing you to bookmark, comment, and upvote directly on the original post. To activate this widget, click on the **companion button** in the top-right corner of the daily.dev menu bar, as seen below:
+**Key features:**
+- Bookmark articles while reading
+- Comment directly on original posts  
+- Upvote content from any site
+- Seamless integration with your feed
+
+**To activate the companion widget:**
+
+1. Click the companion button in your top-right menu:
 
 ![Companion widget activation icon on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1695752806/docs-v2/Companion-widget-icon.png)
 
-Then click on the `Activate companion` button in the description box:
+2. Click "Activate companion" in the dialog:
 
 ![Activate companion widget on daily.dev](https://daily-now-res.cloudinary.com/image/upload/v1695752390/docs-v2/Activate-companion.png)
 
-You will then be asked to grant additional permissions to display the companion widget directly on the original post.
+3. Grant browser permissions to display the widget on external sites.
+
+:::caution Browser Permissions Required
+The companion widget requires additional permissions to function on external websites. This enables daily.dev to overlay its functionality on article pages.
+:::
+
+[Learn more about the companion widget →](/docs/key-features/the-companion)
+
+## Accessibility Features
+
+**Automatically Dismiss Notifications**  
+Enable this setting to automatically close notification messages after a brief display period, reducing visual clutter and interruptions.
+
+:::tip Accessibility Focus
+This feature is particularly helpful for users who prefer minimal interface distractions or use assistive technologies.
+:::