docs: modernize contributor docs and domain/contact references (#4775)

Co-authored-by: Simon Kohnstamm <kohnsts@gmail.com>

Author: QuiltSimon

README.md

@@ -0,0 +1,103 @@
+# Quilt: Scientific Data Management on AWS
+
+[![Docs](https://img.shields.io/badge/Docs-docs.quilt.bio-0B5FFF?style=for-the-badge)](https://docs.quilt.bio/)
+[![Join Office Hours](https://img.shields.io/badge/Join%20Office%20Hours-Live%20Friday-00875A?style=for-the-badge)](https://riverside.com/webinar/registration/eyJzbHVnIjoic2ltb24ta29obnN0YW1tcy1zdHVkaW8iLCJldmVudElkIjoiNjk5Y2M5MDI4YjVkM2Y2MjFjYTk5MzgzIiwicHJvamVjdElkIjoiNjk5Y2M5MDI1OTE5NDU0YmNlOWEzZDVmIn0=)
+[![Book an Intro](https://img.shields.io/badge/Book%20an%20Intro-Meet%20the%20Team-5E4AE3?style=for-the-badge)](https://www.quilt.bio/meetings/simon-kohnstamm/quilt-introduction)
+
+Quilt is a **Scientific Data Management Platform on AWS** that helps teams and
+AI find, trust, and reuse data through deeply versioned, context-rich data
+packages.
+
+Most scientific organizations do not struggle to generate data. They struggle
+to keep it usable over time. As teams, tools, and workflows evolve, context
+gets lost, scientists cannot find what they need, data teams get pulled into
+manual support, and AI projects slow down because data lacks structure,
+lineage, and trust.
+
+Quilt solves this by turning cloud data into durable, searchable, reusable
+packages. Each package captures data plus metadata, documentation, lineage, and
+version history needed for confident reuse. Built on AWS, Quilt works with data
+in place, so organizations can improve data management without disruptive
+migrations or rigid workflows.
+
+## Open Source and Enterprise
+
+Quilt includes both open-source software and an enterprise platform deployment model.
+
+- **Open source (this repository):**
+  - Python SDK and CLI for creating Quilt packages, installing packages
+    locally, and uploading packages to S3 using your AWS credentials
+  - Package versioning, reproducibility, and documentation workflows that fit
+    data science and bioinformatics workloads
+  - Does **not** provide the full hosted search and visualization experience
+    for package discovery and collaboration
+- **Enterprise platform:**
+  - Dedicated AWS-hosted Quilt platform for teams to search, share, and
+    visualize Quilt packages
+  - Multi-user collaboration and governance features on top of open-source
+    package workflows
+
+Start with:
+
+- Open-source docs: [`docs/README.md`](docs/README.md)
+- Enterprise administration docs: [`docs/technical-reference.md`](docs/technical-reference.md)
+- Contributor guide: [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md)
+
+## Repository Map
+
+Use this to find where each major part of Quilt lives.
+
+| Path | What it contains |
+| --- | --- |
+| `api/python` | `quilt3` Python SDK, CLI, and Python tests |
+| `catalog` | Quilt web catalog frontend (TypeScript/JavaScript) |
+| `lambdas` | AWS Lambda services (indexing, previews, events, etc.) |
+| `shared` | Shared schemas and cross-component assets |
+| `py-shared` | Shared Python utilities used by services |
+| `s3-proxy` | S3 proxy service components |
+| `docs` | Product, platform, API, and contributor documentation |
+| `gendocs` | API documentation generation tooling |
+| `testdocs` | Documentation codeblock validation tools |
+
+## Quick Start for Contributors
+
+1. Clone and create a branch:
+
+   ```bash
+   git clone https://github.com/quiltdata/quilt
+   cd quilt
+   git checkout -b my-change
+   ```
+
+2. Install Python task runner:
+
+   ```bash
+   # macOS/Linux
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+3. Run Python tests:
+
+   ```bash
+   cd api/python
+   uv run poe test
+   ```
+
+4. Run catalog locally:
+
+   ```bash
+   cd catalog
+   npm install
+   npm start
+   ```
+
+For full setup, testing, and release steps, see [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md).
+
+## Learn More
+
+- Product docs: [docs.quilt.bio](https://docs.quilt.bio/)
+- Open data demo catalog: [open.quiltdata.com](https://open.quiltdata.com/)
+- Case studies and customer stories: [quilt.bio/case-studies](https://www.quilt.bio/case-studies)
+- Slack community: [Join Quilt Slack][quilt-slack]
+
+[quilt-slack]: https://slack.quilt.bio

api/python/pyproject.toml

@@ -11,7 +11,7 @@ requires-python = ">=3.9"
 license = "Apache-2.0"
 license-files = ["LICENSE"]
 authors = [
-    { name = "quiltdata", email = "contact@quiltdata.io" },
+    { name = "quiltdata", email = "support@quilt.bio" },
 ]
 classifiers = [
     "Development Status :: 5 - Production/Stable",

catalog/Dockerfile

@@ -1,5 +1,5 @@
 FROM amazonlinux:2023.9.20251208.0
-MAINTAINER Quilt Data, Inc. contact@quiltdata.io
+MAINTAINER Quilt Data, Inc. support@quilt.bio
 
 ENV LC_ALL=C.UTF-8
 ENV LANG=C.UTF-8

catalog/app/constants/urls.js

@@ -1,13 +1,13 @@
 /* Constants are a developer's best friend
  * convention: camelcase, no terminating slash */
-export const blog = 'https://blog.quiltdata.com'
+export const blog = 'https://blog.quilt.bio'
 export const docs = 'https://docs.quilt.bio'
 export const gitWeb = 'https://github.com/quiltdata/quilt'
-export const homeMarketing = 'https://quiltdata.com'
+export const homeMarketing = 'https://quilt.bio'
 export const instagram = 'https://www.instagram.com/quiltdata/'
 export const jobs = 'https://quilt-data.breezy.hr/'
 export const linkedin = 'https://www.linkedin.com/company/quilt-data'
-export const slackInvite = 'https://slack.quiltdata.com/'
+export const slackInvite = 'https://slack.quilt.bio'
 export const icon256 = 'https://d1zvn9rasera71.cloudfront.net/q-256-square.png'
 export const tutorial =
   'https://github.com/quiltdata/quilt/blob/master/README.md#tutorial'

catalog/app/containers/Auth/ActivationError.jsx

@@ -2,7 +2,7 @@ import React from 'react'
 
 import * as Layout from './Layout'
 
-const SUPPORT_EMAIL = 'support@quiltdata.io'
+const SUPPORT_EMAIL = 'support@quilt.bio'
 
 const Container = Layout.mkLayout('Activation Error')
 

catalog/app/website/pages/Install/Install.jsx

@@ -12,7 +12,7 @@ const MP_LINK =
   'https://aws.amazon.com/marketplace/pp/Quilt-Data-Quilt-Business/B07QF1VXFQ'
 const PREREQ_LINK =
   'https://docs.quilt.bio/references/technical-reference#before-you-install-quilt'
-const MAILTO = 'mailto:contact@quiltdata.com'
+const MAILTO = 'mailto:support@quilt.bio'
 
 const useStyles = M.makeStyles((t) => ({
   container: {

catalog/package.json

@@ -10,7 +10,7 @@
     "npm": "10",
     "node": "20"
   },
-  "author": "Quilt Data, Inc. <contact@quiltdata.io> (https://quiltdata.com)",
+  "author": "Quilt Data, Inc. <support@quilt.bio> (https://quilt.bio)",
   "license": "MIT",
   "scripts": {
     "analyze:clean": "rimraf stats.json",

docs/CONTRIBUTING.md

@@ -4,9 +4,12 @@ Quilt is an open source project, and we welcome contributions from the community
 
 Contributors must adhere to the [Code of Conduct](https://github.com/quiltdata/quilt/blob/master/docs/CODE_OF_CONDUCT.md).
 
+If you are looking for a quick map of where major components live, start with the
+repository [`README.md`](../README.md).
+
 ## Reporting issues
 
-Unsure about something? To get support, check out our [Slack channel](https://quiltusers.slack.com/messages).
+Unsure about something? To get support, check out our [Slack community](https://slack.quilt.bio).
 
 Found a bug? File it in our [GitHub issues](https://github.com/quiltdata/quilt/issues).
 
@@ -28,6 +31,13 @@ git checkout -B new-branch-name
 
 ## Local package development
 
+Choose your area first:
+
+- Python SDK and CLI work: `api/python`
+- Web catalog work: `catalog`
+- AWS services and background processing: `lambdas`
+- Platform and user docs: `docs`
+
 ### Python Environment
 
 We use [`uv`](https://github.com/astral-sh/uv) for dependency management.
@@ -41,7 +51,7 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 pip install uv
 ```
 
-`uv` ensures the environemnt is properly set up before executing a command,
+`uv` ensures the environment is properly set up before executing a command,
 so you don't have to do anything else.
 
 Run `uv run poe` to see all configured tasks (or refer to `pyproject.toml`).
@@ -92,7 +102,12 @@ To build a static code bundle, as would be necessary in order to serve the catal
 npm run build
 ```
 
-<!-- TODO: add configuration instructions -->
+To run the catalog locally, create a development config:
+
+```bash
+cp config.js.example static-dev/config.js
+# edit static-dev/config.js for your environment
+```
 
 To run the catalog in developer mode:
 

docs/Catalog/Admin.md

@@ -95,7 +95,7 @@ By default, when you add a bucket to the Quilt stack one of two things will happ
 
 If either of the above conditions fails, Quilt will not add the bucket in question.
 
-See [S3 Events, EventBridge](EventBridge.md) for more.
+See [S3 Events, EventBridge](../EventBridge.md) for more.
 
 ## Settings
 

docs/Catalog/Installation.md

@@ -21,10 +21,12 @@ We recommend that all users do one or more of the following:
 * [Schedule a Quilt engineer](https://calendly.com/d/g6f-vnd-qf3/engineering-team)
 to guide you through the installation
 
-* [Join Quilt on Slack](https://slack.quiltdata.com/) to ask questions and
-connect with other users
+* [Join Quilt on Slack][quilt-slack] to ask questions and connect with other
+users
 
-* [Email Quilt](mailto:contact@quiltdata.io)
+* [Email Quilt](mailto:support@quilt.bio)
+
+[quilt-slack]: https://slack.quilt.bio
 
 ## Requirements and Prerequisites
 
@@ -106,7 +108,7 @@ recommend that you [contact us first](#help-and-advice).
 
 ### AWS Service Catalog
 
-1. Email [contact@quiltdata.io](mailto:contact@quiltdata.io)
+1. Email [support@quilt.bio](mailto:support@quilt.bio)
 with your AWS account ID to request access to Quilt through the
 AWS Service Catalog and to obtain a license key.
 1. Click the service catalog link that you received from Quilt.