Reorganize Virtual Coffee Resources (#895)

* Update Slack channel guide

* Move Code of Conduct section in guide-to-vc to its own page

* Move what to expect in virtual coffee section to its own page
* Update meta order

* Restructure Code of Conduct page in resources
* Fix wordings
* Add svg image

* Fix wordings and restructure What to Expect in Virtual Coffee page
* Add svg image

* Move Coffee Table Groups section to its own page

* Add volunteering section into coffee table groups page

* Move Monthly Challenges section into its own page

* Add events list to virtual coffee events section in what to expect in vc page
* Change the link to lunch and learns

* Move Lightning Talks section into its own page
* Add svg

* Move Hacktoberfest (Initiative) section into its own page
* Add svg

* Fix link to hacktoberfest initiative

* Minor fix

* Fix link to Lightning Talk

* Minor typo fix

* Move giving back to the community section into its own page
* Add svg

* Move keeping up with vc section into its own page
* Add svg

* Move new pages into virtual coffee handbook folder
* Add svg
* Fix meta order

* Reorder meta index

* Minor typo fix in virtual coffee handbook

* Move faq around joining vc to its own folder
* Reorder meta index in virtual coffee folder

* Rename vc handbook folder to guide to vc
* Fix broken links
* Add svg
* Change title of vc member resources to vc handbook

* Fix wordings across pages in guide to virtual coffee

* Add svg and change hero image of index.md of get involved

* Fix layout of Paths to leadership to be consistent accross resources
* Fix wordings in Paths to leadership

* Fix links and wordings in Lunch & Learns page in get involved
* Minor fix in paths to leadership page

* Rename coffee-table-groups.mdx in get-involved to leading-coffee-table-groups.mdx

* Fix links and wordings in leading coffee table group page
* Fix links and wordings in coffee table group page
* Add breakline in join virtual coffee index page

* Create developer-resources folder
* Create developer-tips folder
* Create index.mdx for developer-resources and developer-tips
* Move developer-health, developer-tips and open-source into developer-resources
* Add svgs

* Prettified Code!

* Revert "Prettified Code!"

This reverts commit e572fec.

* Prettified Code!

* Revert "Prettified Code!"

This reverts commit f5be7e8.

* Rename coding-questions-guide to asking-coding-questions
* Fix wordings and layout in asking-coding-questions and index.md pages in developer-tips

* Fix wordings and layout in burnout page
* Fix wordings in index.md of developer-health

* Testing index page layout

* Prettified Code!

* Add intro to all index pages
Fix wordings and layout in all index pages

* Add apprreciation section in index page of open-source, asking-coding-questions and burnout pages
* Fix wordings, layout and a link

* Update coffee-table-groups page in guide to vc
* Minor fix in paths-to-leadership page

* Update the pages under open-source resources folder

* Prettified Code!

* Fix prettier error with prettier-ignore
Change format of a resources list from ul to dl

* Add glossary to guide to vc
Add svg

* Fix list format accross pages in open source section

* Remove Transcending the CisTem from coffee table group

* Update announcements and vc-events channel description
* Rename slack-channel-guide to slack-channels-guide

* Rename virtual-coffee folder to virtual-coffee-handbook
* Rename guide-to-virtual-coffee folder to guides-to-virtual-coffee
* Move lunch-and-learns.mdx to guides-to-virtual-coffee folder
* Reorder meta order in guides-to-virtual-coffee
* Update content across pages in resources
* Fix links across pages in resources
* Fix format across pages in resources

* Add link to faq on index.jsx in the join folder
* Minor wording fix

* Fix link to paths-to-leadership on volunteer at virtual coffee form

* Add neurodiverse.mdx to developer-health
* Add svg

* Prettified Code!

* Fix link in start-coffee-table-group form
* Add a link in start-coffee-table-group form

* Minor wordings fix on about page

* Update content in index.mdx of resources
* Minor fix in index.mdx of virtual-coffee-handbook

* Update content index.md of join-virtual-coffee

* Update faq.mdx

* Update code-of-conduct.mdx
* Minor fix in index.mdx of guides-to-virtual-coffee

* Update content in what-to-expect-in-virtual-coffee.mdx

* Update content in slack-channels-guide.mdx

* Update content in coffee-table-groups.mdx

* Update monthly-challenges.mdx

* Update content in lunch-and-learns.mdx

* Update content in lightning-talk.mdx

* Minor fixes in hacktoberfest-initiative.mdx

* Update content in giving-back-to-the-community.mdx

* Update content in keeping-up-with-virtual-coffee.mdx

* Update content in glossary.mdx

* Minor fixes in index.mdx of get-involved
* Minor fixes in leading-coffee-table-groups

* Wording fixes in paths-to-leadership.mdx

* Fix wordings in index.mdx of developer-resources

* Update content in asking-coding-questions.mdx
* Minor fix in index.mdx of developer-tips

* Update wordings in index.mdx of developer-health

* Minor fixes in burnout.mdx
* Minor fixes in neurodiverse.mdx

* Update content in about-open-source.mdx
* Minor fix in index.mdx of open-source

* Update content in git-101.mdx

* Minor wordings fixes in contributor-guide.mdx
* Fix titles' capitalization in contributor-guide.mdx

* Fix DigitalOcean name format in hacktoberfest-initiative.mdx and glossary.mdx

* Fix wordings and titles capitalization in maintainer-guide.mdx

* combine join pages

* Allow PostList to set depth level

* rename levels to depth

* Fix link to join-virtual-coffee in index.jsx of join

* Minor wordings fix in burnout.mdx

* Wordings fix in asking-coding-questions.mdx

* Minor wording fix in index.mdx of open-source

* Minor wording fix in about-open-source.mdx

* Minor wording fix in git-101.mdx

* Fix titles in resources section in maintainer-guide.mdx

* Fix wordings in burnout.mdx

* Fix wordings in index.mdx of developer-tips

* Fix wordings in about-open-source.mdx

* Fix wordings in index.mdx of get-involved

* Remove <Link> in index.mdx of resources

* Fix wordings in glossary.mdx

* Fix wordings in lightning-talk.mdx

* Fix wordings in lunch-and-learns.mdx

* Fix wordings in index.jsx of start-coffee-table-group

* Fix wordings in index.mdx of join-virtual-coffee

* Add link to get involved

* Fix wordings in slack-channels-guide.mdx

* Fix wordings in contributor-guide.mdx

* Minor fix em dash in coffee-table-groups.mdx

* Fix wordings in what-to-expect-in-virtual-coffee.mdx

* Fix wordings in hacktober-initiative.mdx
* Add link to youtube about hacktober initiative

* Fix wordings in about.mdx

* Bold some words in index.mdx of resources

* Minor fix in glossary.mdx

* Prettified Code!

* Add link to coworking blog post

---------

Co-authored-by: Dan Ott <[email protected]>
Co-authored-by: danieltott <[email protected]>
Co-authored-by: adiati98 <[email protected]>

app/components/PostList.tsx

@@ -69,15 +69,30 @@ export type FileListItem = {
 
 export function formatFileListItemsForPostList(
 	items?: FileListItem[],
+	depth?: number,
+	curLevel?: number,
 ): PostListItem[] | null {
-	return items
-		? items.map(
-				(item): PostListItem => ({
-					title: item.meta.title,
-					description: item.meta.description,
-					to: `/${item.slug}`,
-					children: formatFileListItemsForPostList(item.children),
-				}),
-		  )
-		: null;
+	const internalCurLevel: number =
+		typeof curLevel === 'undefined' ? (curLevel = 0) : curLevel;
+
+	if (typeof depth === 'undefined') {
+		depth = Infinity;
+	}
+
+	if (!items || internalCurLevel >= depth) {
+		return null;
+	}
+
+	return items.map(
+		(item): PostListItem => ({
+			title: item.meta.title,
+			description: item.meta.description,
+			to: `/${item.slug}`,
+			children: formatFileListItemsForPostList(
+				item.children,
+				depth,
+				internalCurLevel + 1,
+			),
+		}),
+	);
 }

app/components/content/FileIndex.tsx

@@ -6,6 +6,7 @@ import type { FileListItem } from '~/components/PostList';
 
 type FileIndexProps = {
 	subDirectory?: string;
+	depth?: number;
 };
 
 function findBase(files: FileListItem[], subDirectory: string): FileListItem[] {
@@ -65,9 +66,9 @@ function findBase(files: FileListItem[], subDirectory: string): FileListItem[] {
 	return filtered;
 }
 
-export default function FileIndex({ subDirectory }: FileIndexProps) {
+export default function FileIndex({ subDirectory, depth }: FileIndexProps) {
 	const allFiles: FileListItem[] = useOutletContext();
 
 	const result = subDirectory ? findBase(allFiles, subDirectory) : allFiles;
-	return <PostList items={formatFileListItemsForPostList(result)} />;
+	return <PostList items={formatFileListItemsForPostList(result, depth)} />;
 }

app/routes/__frontend/__simpleMdx/about.mdx

@@ -1,26 +1,26 @@
 ---
 meta:
   title: About Virtual Coffee
-  description: 'All about Virtual Coffee: Our Mission, Core Values, History, and more.'
+  description: All about Virtual Coffee. Our Mission, Core Values, History, and more.
 hero:
   Hero: UndrawDreamer
 ---
 
 import { Link } from '@remix-run/react';
 
-## Who we are
+## Who We Are
 
-Virtual Coffee is, and always will be, a genuine community of people who value and prioritize supporting one another. We know that growth comes at all levels and that no matter what stage of the developer journey you're on, you can teach and learn.
+Virtual Coffee is, and always will be, a genuine community of people who value and prioritize supporting one another. We know that growth comes at all levels and that you can teach and learn no matter what stage of the developer journey you're on.
 
-Our twice-weekly live coffees with devs at all stages of the journey has grown into an online community that mentors, creates educational content, and provides a safe community at no cost. Since our first coffee in April 2020, we've added a lively slack, a site, Lunch & Learn talks, an Interview Series, a Hacktoberfest Initiative, and Lightning Talks.
+Since our first Coffee in April 2020, our free online tech community has grown to support developers at all stages of the journey. In addition to twice-weekly live Coffees, we've added a site and lively Slack. Our community mentors and creates educational content in various formats, including Lunch and Learn talks, a Hacktoberfest Initiative, opportunities to practice public speaking, monthly challenges, Coffee Table Groups, and more. We also won the [DevRel Awards 2022 as the "Most welcoming developer community"](https://youtu.be/uIby7vyYHVg).
 
-Virtual Coffee is focused on being a positive and supporting place. We’re here to cheer you on when you land a job, get a promotion, or write your first blog post.
+Virtual Coffee is focused on being a positive and supportive place. We’re here to cheer you on when you land a job, get a promotion, or write your first blog post.
 
 ---
 
 ## Our Mission
 
-Virtual Coffee's mission is to be a welcoming tech community that allows room for growth and mentorship at all levels, and to create meaningful opportunities for learning, leadership, and contribution for everyone.
+Virtual Coffee's mission is to be a welcoming tech community that allows room for growth and mentorship at all levels and to create meaningful opportunities for learning, leadership, and contribution for everyone.
 
 ## Our Vision
 
@@ -33,17 +33,17 @@ We welcome and support developers at all stages to create a more empathetic tech
 - We create and support positive and inclusive community.
 - We work to remove tech barriers.
 - We believe everyone has the ability to teach and learn, and that collaboration of developers at all stages enriches our community.
-- We meet people where they are, make space for everyone, and encourage the exchange and explorations of new ideas to create close relationships.
+- We meet people where they are, make space for everyone, and encourage the exchange and exploration of new ideas to create close relationships.
 - We believe in a growth-mindset and encourage and create meaningful opportunities for learning and mentorship, creating a closer community through participation, leadership, and contributions.
-- We value synchronous communication and events as a medium that encourages all of the above and enriches the asynchronous experiences.
+- We value synchronous communication and events as a medium that encourages all of the above and enriches asynchronous experiences.
 
 ---
 
 ## Becoming a Member
 
-Virtual Coffee is a community that welcomes people at all stages of their tech journey. Our mission is to be a welcoming tech community that allows room for growth and mentorship at all levels, and to create meaningful opportunities for learning, leadership, and contribution for everyone.
+Virtual Coffee is a community that welcomes people at all stages of their tech journey. Our mission is to be a welcoming tech community that allows room for growth and mentorship at all levels and to create meaningful opportunities for learning, leadership, and contribution for everyone.
 
-To preserve what makes Virtual Coffee special and support our existing members, we intentionally keep our group small. We'd love to have everyone as a part of Virtual Coffee, but we prioritize the intimacy and closeness of the group. Our community is currently accepting members on a limited basis. As new membership becomes available, we'll reach out to those on the waitlist to join.
+We intentionally keep our group small to preserve what makes Virtual Coffee special and support our existing members. We'd love to have everyone as a part of Virtual Coffee, but we prioritize the intimacy and closeness of the group. Our community is currently accepting members on a limited basis. As new membership becomes available, we'll reach out to those on the waitlist to join.
 
 <Link to="/join" className="text-lg">
 	Join the Waitlist!

app/routes/__frontend/join/index.jsx

@@ -1,6 +1,7 @@
 import { json } from '@remix-run/node';
 import DefaultLayout from '~/components/layouts/DefaultLayout';
 import { createMetaData } from '~/util/createMetaData.server';
+import { Link } from '@remix-run/react';
 
 export async function loader() {
 	return json({
@@ -29,17 +30,24 @@ export default function Join() {
 					<p>
 						Virtual Coffee is a community that welcomes people at all stages of
 						their tech journey. Our mission is to be a welcoming tech community
-						that allows room for growth and mentorship at all levels, and to
+						that allows room for growth and mentorship at all levels and to
 						create meaningful opportunities for learning, leadership, and
 						contribution for everyone.
 					</p>
 					<p>
-						To preserve what makes Virtual Coffee special and support our
-						existing members, we intentionally keep our group small. We'd love
-						to have everyone as a part of Virtual Coffee, but we prioritize the
-						intimacy and closeness of the group. Our community is currently
-						accepting members on a limited basis. As new membership becomes
-						available, we'll reach out to those on the waitlist to join.
+						We intentionally keep our group small to preserve what makes Virtual
+						Coffee special and support our existing members. We'd love to have
+						everyone as a part of Virtual Coffee, but we prioritize the intimacy
+						and closeness of the group. Our community is currently accepting
+						members on a limited basis. As new membership becomes available,
+						we'll reach out to those on the waitlist to join.
+					</p>
+					<p>
+						In the meantime, feel free to check out the{' '}
+						<Link to="/resources/virtual-coffee-handbook/join-virtual-coffee">
+							FAQ about joining Virtual Coffee
+						</Link>
+						.
 					</p>
 					<div className="mt-5 text-center">
 						<a

app/routes/__frontend/resources/developer-resources/developer-health/burnout.mdx

@@ -0,0 +1,103 @@
+---
+meta:
+  title: Burnout
+  description: A collection of guides to help with developer burnout.
+hero:
+  Hero: UndrawMeditating
+tags:
+  - memberresources
+  - memberresourcesIndex
+order: 1
+---
+
+import TextContainer from '~/components/content/TextContainer';
+import LeadText from '~/components/content/LeadText';
+
+<TextContainer background="light" showBackToTopLink={false}>
+
+<LeadText>
+
+Developer burnout is an experience that's too prevalent in the tech industry. It often results from stress, a lack of psychological safety, negative experiences, or feedback in the workplace. The results include exhaustion, an inability to complete work tasks effectively, a lack of desire to work, ambivalence towards work or teammates, and more.
+
+Removing yourself from the situation might be the best way to recover from burnout. However, that’s not always an option. You can find some tips to navigate burnout in this article.
+
+</LeadText>
+
+</TextContainer>
+
+## Table of Contents
+
+<TextContainer>
+
+---
+
+## Removing Negative Influences
+
+We often find that shame influences our interactions and what we agree to. Identifying where you feel shame and how it impacts your burnout is a good first step. Let go of the guilt of needing a break, saying no, passing a project to another colleague, etc.
+
+Sometimes you must step away from the things you can no longer sustain. You may have taken on too much, or you changed your priorities. That’s ok. Learning to pause and step away from things is important. Trying to do too much will accelerate burnout.
+
+</TextContainer>
+
+<TextContainer>
+
+## Increasing Positive Influences
+
+Counteracting the negative influences in your life by investing in the people and things that bring you energy or happiness can help to navigate burnout. Find the activities that bring you joy and comfort, and incorporate those into your week. Put them on your schedule as you would work meetings or interviews to signify their importance and necessity. This might be playing games, watching movies, hanging out with friends and family, heading to the gym, or doing any activity that gives you energy. Along with that, it’s ok and good to rest. Finding space not to do things is equally essential in replenishing your energy.
+
+Sometimes, physically staying in the same place increases feelings of burnout and being trapped. Try moving your workspace and incorporating regular body movement. It might help to set some achievable physical goals like walking X every week or starting a 100-day push-up challenge.
+
+Create adequate time to wind down every day. This will also contribute to much better sleep, which is essential for burnout recovery.
+
+Let yourself be bored! Daydream, dream about new projects, think abstractly about concepts you’ve learned, identify new connections between parts of yourself, reflect on what learning approaches worked well, and even pursue some opportunities you hadn’t considered.
+
+</TextContainer>
+
+<TextContainer>
+
+## Create Boundaries
+
+Boundaries help to keep us healthy, but often we find that we’ve let things cross our boundaries or the boundaries have blurred. You may have worked late one week to hit a big goal for your job. Suddenly, you find that you’re being asked to do that—or worse, you’re being expected to do it without your consent—for everyday tasks. It’s not in your contract, and you value work-life harmony.
+
+Regularly assessing your upcoming week and retrospect to identify the biggest stressors can help prevent this from continuing. You may identify ways to improve your stressors by reducing hours, taking more breaks, setting a day without meetings, or finding space to work in an environment conducive to doing your best work. Consider doing a self-reflection as well.
+
+To assess your week, set a stop time for every day. Although it may be necessary to push past that in some instances, it’s important to make that the exception and not the rule.
+
+</TextContainer>
+
+<TextContainer>
+
+## Affirmations
+
+Identify affirmations that feel authentic to you, such as:
+
+- I matter.
+- My worth isn't tied to my productivity, side projects, or job title.
+- I am more than my rejections.
+- I am important.
+
+Then, make it a habit, like repeating these affirmations for 3-5 minutes once or twice a day. If affirmations feel inauthentic to you, try writing down one thing you're grateful for every day. These habits help you remember that you have something you cherish and your life is multi-dimensional.
+
+</TextContainer>
+
+<TextContainer>
+
+## Resources
+
+- [You're Not Just Tired: The Psychology of Burnout](https://www.youtube.com/watch?v=-XYK8ulQId0) by Arthur Doler
+
+- [The History of Burnout](https://www.youtube.com/watch?v=usWGg6xKHW0&list=PL_loxoCVsWqxj0ocM5GjaDsEdfLfWCdHW) by Kati Morton
+
+</TextContainer>
+
+<TextContainer background="light">
+
+## Appreciation
+
+<LeadText>
+
+Thanks to all our members who contributed to this conversation, especially **Julia Seidman** and **Kieran(they/them)**!
+
+</LeadText>
+
+</TextContainer>

app/routes/__frontend/resources/developer-resources/developer-health/index.mdx

@@ -0,0 +1,33 @@
+---
+meta:
+  title: Developer Health
+  description: A collection of guides by our members to help with developers' mental health, burnout, self-care, and more.
+hero:
+  Hero: UndrawWorkout
+tags:
+  - memberresources
+  - memberresourcesIndex
+order: 3
+---
+
+import LeadText from '~/components/content/LeadText';
+import TextContainer from '~/components/content/TextContainer';
+import FileIndex from '~/components/content/FileIndex';
+
+<TextContainer background="light" showBackToTopLink={false}>
+
+<LeadText>
+
+We sometimes forget to nourish our bodies, minds, and spirits because of our workload. It often results in burnout, stress, or other health problems. In this guide, you can find resources to help you become healthier developers. Health always comes first, and healthy developers are happy developers!
+
+</LeadText>
+
+</TextContainer>
+
+<TextContainer showBackToTopLink={false}>
+
+## Guides Available:
+
+<FileIndex subDirectory="resources/developer-resources/developer-health" />
+
+</TextContainer>