Update Docusaurus configuration and documentation for clarity and consistency

- Changed the tagline in docusaurus.config.js to reflect the updated focus on the task manager for engineers.
- Replaced the hardcoded handbook URL with a constant imported from src/constants.js for better maintainability.
- Deleted the outdated roadmap.md file and created a new roadmap.mdx file linking to the handbook for improved accessibility.
- Added a new contribute.mdx file outlining contribution guidelines and expectations, emphasizing alignment with project goals.
- Introduced src/constants.js to centralize external URLs and constants.

Author: tyler-dane

.github/copilot-instructions.md

@@ -2,7 +2,7 @@
 
 **ALWAYS follow these instructions first.** Only fallback to additional search and context gathering if the information in these instructions is incomplete or found to be in error.
 
-Compass Docs is a Docusaurus v3.x documentation site for the Compass calendar application. It provides comprehensive documentation for developers and users of the open-source calendar for minimalists.
+Compass Docs is a Docusaurus v3.x documentation site for the Compass task manager. It provides comprehensive documentation for developers and users of the open-source task manager for engineers.
 
 ## Branch Naming & Commit Message Conventions
 

docs/contribute/contribute.md docs/contribute/contribute.mdxdocs/contribute/contribute.md renamed to docs/contribute/contribute.mdx

@@ -2,6 +2,8 @@
 sidebar_position: 1
 ---
 
+import { HANDBOOK_URL } from "../../src/constants.js";
+
 # How to Contribute
 
 ## Setting Expectations
@@ -11,42 +13,42 @@ We're laser-focused on two things:
 1. Helping minimalists manage their schedule and focus, so they can do more of what matters
 2. Being profitable, so that we can continue doing #1 for decades
 
-We're only accepting contributions that help us reach those goals. If you submit a PR that doesn't align with our goals, it will be rejected. The best way to avoid this scenario is to confirm that your proposed changes align with our priorities. You can verify this by reviewing the [Roadmap](../roadmap.md) and timeline (more links and details on how to do this below).
+We're only accepting contributions that help us reach those goals. If you submit a PR that doesn't align with our goals, it will be rejected. The best way to avoid this scenario is to confirm that your proposed changes align with our priorities. You can verify this by reviewing the [Roadmap](../roadmap.mdx) and timeline (more links and details on how to do this below).
 
 If these goals align with your own, we'd love to work with you!
 
 ### What's in it for you
 
-#### 🚀 Experience
+#### Experience
 
 Working on Compass gives you unique experience that you won't get anywhere else.
 
 - **Meritocracy**: Compass operates on outputs, not resumes or locales. An Ex-Googler in SF gets the same treatment as someone in Mongolia who just learned HTML; We only care about the quality of the work you can produce.
 
 - **Fullstack**: Since this is an open-source monorepo, you can get experience getting things to work end-to-end without silos. This'll help you become a true fullstack engineer.
 
-- **Transparency**: Code isn't the only thing that we're transparent about. We publish our [handbook](https://compasscalendar.notion.site/), roadmap, technical guides, and lessons-learned across our repos and social media. Working in an open culture will give you more opportunities to grow as an engineer and leader.
+- **Transparency**: Code isn't the only thing that we're transparent about. We publish our <a href={HANDBOOK_URL} target="_blank" rel="noopener noreferrer">handbook</a>, roadmap, technical guides, and lessons-learned across our repos and social media. Working in an open culture will give you more opportunities to grow as an engineer and leader.
 
-#### 🏆 Recognition
+#### Recognition
 
 What may be offered after consistent excellence\*:
 
-- 📝 Reference for your next job
-- 📈 Compensation
-- 📈 Preference for future opportunities @ Switchback (the company behind Compass)
+- Reference for your next job
+- Compensation
+- Preference for future opportunities @ Switchback (the company behind Compass)
 
 \*These are the criteria we use to assess the quality of your work. If you don't meet these criteria, we may reject your PR.
 
 1. **Code quality**: Is the code readable, well-organized, and testable? Does it follow best practices? Does it provide good UX?
-2. **Expertise**: Does your work reflect your skill level? Did you need a lot of technical guidance in order to get started? Were you able to make good judgments about the requirements and implementation?
-3. **Communication**: If you got blocked, did you reach out for help? Did you communicate your plans and progress clearly? Are your commits, PR descriptions, and comments easy to understand?
+2. **Expertise**: Does your work reflect your skill level? Did you need a lot of technical guidance in order to get started? Were you able to make good judgments about the requirements and implementation?
+3. **Communication**: If you got blocked, did you reach out for help? Did you communicate your plans and progress clearly? Are your commits, PR descriptions, and comments easy to understand?
 4. **Reliability**: Did you submit your PR, update based on comments in a timely manner? If something came up that prevented you from completing a PR on time, did you let us know?
 
 ## Workflows
 
-### 🏁 You're ready to pick up a new task
+### You're ready to pick up a new task
 
-1. Review the [roadmap](../roadmap.md) to confirm that the issue you'd like to work on is aligned with our goals
+1. Review the [roadmap](../roadmap.mdx) to confirm that the issue you'd like to work on is aligned with our goals
 1. Review [the quarterly backlog](https://github.com/orgs/SwitchbackTech/projects/4/views/8). This is the view that shows each important issue by the quarter it's planned for.
 1. Review [the timeline](https://github.com/orgs/SwitchbackTech/projects/4/views/7) to confirm that you could finish the issue you'd like to work on before its deadline.
 1. If this is your first time contributing, pick an issue in the `Ready` state for the _next_ quarter that has a `Good first issue` tag. Working on an issue in the next quarter gives you time to familiarize yourself with the codebase while still working on a priority change. It also gives us the chance to assess the quality of work and your reliability before giving you more responsibility.
@@ -62,16 +64,16 @@ What may be offered after consistent excellence\*:
 1. Link the PR to the issue it solves by including the issue number in the PR description and using a [closing keyword](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests#linking-a-pull-request-to-an-issue). For example: `Fixes #123`
 1. Wait for feedback. You can continue this process with another issue while waiting for feedback.
 
-### 🐞 You found an undocumented bug
+### You found an undocumented bug
 
 - If the bug is a security vulnerability, please [report it here](https://github.com/SwitchbackTech/compass/security).
 - Ensure the bug was not already reported by searching under the issues
 - If it's a new bug, open a new issue, including as much relevant information as possible.
 
-### ☝️ You want to add a new feature or dramatically change an existing one
+### You want to add a new feature or dramatically change an existing one
 
-Larger features or changes that are not already on our [Roadmap](../roadmap.md) or in the backlog will most likely be rejected. If you're unsure, open a GitHub issue before you start working. This will help ensure that your work is aligned with the project's goals and that you don't spend time on something that won't be prioritized.
+Larger features or changes that are not already on our [Roadmap](../roadmap.mdx) or in the backlog will most likely be rejected. If you're unsure, open a GitHub issue before you start working. This will help ensure that your work is aligned with the project's goals and that you don't spend time on something that won't be prioritized.
 
-### 💅 You fixed whitespace, formatted code, or made a purely cosmetic patch
+### You fixed whitespace, formatted code, or made a purely cosmetic patch
 
 Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability will generally not be accepted.

docs/roadmap.md

@@ -0,0 +1,5 @@
+import { HANDBOOK_URL } from "../src/constants.js";
+
+# Roadmap
+
+The roadmap has been moved to our <a href={HANDBOOK_URL} target="_blank" rel="noopener noreferrer">public handbook</a>.

docs/roadmap.mdx

@@ -4,11 +4,13 @@
 const lightCodeTheme = require("prism-react-renderer/themes/github");
 const darkCodeTheme = require("prism-react-renderer/themes/dracula");
 
+// Import constants from central location
+const { HANDBOOK_URL } = require("./src/constants.js");
+
 /** @type {import('@docusaurus/types').Config} */
 const config = {
   title: "Compass Docs",
-  tagline:
-    "Learn how to use Compass, the open source calendar for minimalists.",
+  tagline: "Learn how to use Compass, the task manager for engineers.",
   favicon: "img/favicon.ico",
   url: "https://docs.compasscalendar.com",
   // Set the /<baseUrl>/ pathname under which your site is served
@@ -112,7 +114,7 @@ const config = {
               },
               {
                 label: "Handbook",
-                href: "https://compasscalendar.notion.site/",
+                href: HANDBOOK_URL,
               },
               {
                 label: "Blog",

docusaurus.config.js

@@ -0,0 +1,6 @@
+// Central location for external URLs and constants
+const HANDBOOK_URL =
+  "https://compasscalendar.notion.site/Compass-Handbook-26b237bde8f4805c9a56de6db3a7993d?source=copy_link";
+
+module.exports = { HANDBOOK_URL };
+module.exports.HANDBOOK_URL = HANDBOOK_URL;