feat(docs): add in-app documentation system

.github/workflows/ci-frontend.yml

@@ -239,7 +239,7 @@ jobs:
       - name: Build and push
         uses: docker/build-push-action@v6
         with:
-          context: frontend/
+          context: .
           file: frontend/Dockerfile
           push: ${{ github.event_name != 'pull_request' }}
           tags: ${{ steps.meta.outputs.tags }}

.github/workflows/ci-release.yml

@@ -81,7 +81,7 @@ jobs:
       - name: Build and push
         uses: docker/build-push-action@f9f3042f7e2789586610d6e8b85c8f03e5195baf  # v7.2.0
         with:
-          context: frontend/
+          context: .
           file: frontend/Dockerfile
           push: true
           tags: ${{ steps.meta.outputs.tags }}

.mlc_config.json

@@ -8,6 +8,18 @@
     },
     {
       "pattern": "^https://github\\.com/mlehotskylf"
+    },
+    {
+      "pattern": "^/images/",
+      "comment": "App-relative image paths served by the Nuxt frontend (frontend/public/images/) — not resolvable by offline link checkers"
+    },
+    {
+      "pattern": "^/for-companies",
+      "comment": "App-relative route (frontend/app/pages/for-companies.vue) — not resolvable by offline link checkers"
+    },
+    {
+      "pattern": "^https://crowdfunding\\.linuxfoundation\\.org/images/docs/",
+      "comment": "Docs screenshot images served from the production LFX Crowdfunding site — not yet available in CI (site not yet deployed to production)"
     }
   ],
   "timeout": "20s",

docs/user/backers/index.md

@@ -0,0 +1,36 @@
+---
+title: Backers
+description: Understand how supporters are listed on initiative pages on LFX Crowdfunding.
+tags: [backers, supporters, donors, donations, anonymous]
+last_updated: 2026-06-17
+display_order: 6
+intercom_collection: LFX Crowdfunding
+---
+
+This page explains how donors are listed on initiative pages. If you want to make a donation, see [Donations](../donations/).
+
+Every initiative publicly recognises the people and organisations that have contributed to it. Backers are listed in two places on each initiative page.
+
+## Recent donations sidebar
+
+The initiative overview shows the most recent donations in a sidebar, including each backer's name, avatar, amount, and how long ago the donation was made.
+
+## Financials tab
+
+The **Financials** tab contains a full donations table with each backer's:
+
+- Name and avatar
+- Donor type — **Individual** or **Company**
+- Donation amount
+- Date
+
+Use the **Load more** button at the bottom of the table to see older donations.
+
+## Anonymous donations
+
+If a donor's information is not available, their name is shown as **Anonymous**. There is no way to filter or exclude anonymous donations from the list.
+
+## Related sections
+
+- [Donations](../donations/) — how to make a donation
+- [Initiatives](../initiatives/) — browse campaigns

docs/user/donations/index.md

@@ -0,0 +1,45 @@
+---
+title: Donations
+description: Learn how to donate to open source initiatives and manage your giving history on LFX Crowdfunding.
+tags: [donations, giving, payments, recurring]
+last_updated: 2026-06-17
+display_order: 3
+intercom_collection: LFX Crowdfunding
+---
+
+Donating to an initiative supports open source projects directly. All payments are processed securely through Stripe.
+
+> **Sign in required** — Making a donation requires an [LF ID](https://openprofile.dev/) account. You will be prompted to log in before your payment is processed.
+
+## Making a donation
+
+1. Open any published [initiative](../initiatives/) page
+2. Click the **Donate** button
+3. Choose a donation amount or enter a custom amount
+4. Select **One-time** or **Monthly** recurring
+5. Enter your payment details and confirm
+
+For a detailed walkthrough, see [Making a Donation](./make-donation/).
+
+## One-time vs. monthly donations
+
+**One-time** donations are a single charge processed immediately.
+
+**Monthly** donations are charged on the same date each month. You can cancel at any time — see [Managing Your Donations](./manage-donations/).
+
+## Donation history and managing subscriptions
+
+Your past donations and active monthly subscriptions are managed through the LFX platform. See [Managing Your Donations](./manage-donations/) for details.
+
+## Email acknowledgement and tax information
+
+All donations are made to the Linux Foundation, a 501(c)(6) non-profit organisation (a category of non-profit under US tax law). An email acknowledgement is sent automatically after each payment. For tax purposes, please consult your tax adviser regarding the deductibility of your donations.
+
+## Payment security
+
+Payments are processed by [Stripe](https://stripe.com). LFX Crowdfunding never stores your full card details.
+
+## Related sections
+
+- [Getting Started](../getting-started/) — overview of the platform
+- [Initiatives](../initiatives/) — browse campaigns to donate to

docs/user/donations/make-donation/index.md

@@ -0,0 +1,53 @@
+---
+title: Making a Donation
+description: How to make a one-time or monthly donation to an open source initiative on LFX Crowdfunding.
+tags: [donations, one-time, monthly, payment, stripe]
+last_updated: 2026-06-17
+display_order: 1
+intercom_collection: LFX Crowdfunding
+---
+
+> **Sign in required** — You must be signed in with your [LF ID](https://openprofile.dev/) to make a donation.
+
+## Starting a donation
+
+Open any published initiative page and click the **Donate** button. A drawer will open with the donation form.
+
+## Step 1 — Choose an amount and frequency
+
+![Donation amount selection](https://crowdfunding.linuxfoundation.org/images/docs/donation-step-amount.png)
+
+Select a preset amount or enter a custom amount in the input field.
+
+Then choose your donation frequency:
+
+- **One-time** — a single charge processed immediately
+- **Monthly** — a recurring charge on the same date each month
+
+Optionally, you can allocate your donation to a specific funding goal (e.g. Development, Marketing, Travel) if the initiative has defined funding categories. By default your donation goes toward all project needs.
+
+## Step 2 — Payment
+
+![Donation payment step](https://crowdfunding.linuxfoundation.org/images/docs/donation-step-payment.png)
+
+Enter your card details:
+
+- Card number
+- Expiry date
+- CVC
+
+If you have previously saved a card, it will be shown here. You can use it directly or click **Use a different card** to enter new details.
+
+**Order summary** — The drawer shows a breakdown of your donation amount and total. The Linux Foundation underwrites all transaction fees, so 100% of your donation goes to the initiative.
+
+Click **Donate** to process your payment. For cards that require additional verification (3D Secure — an extra authentication step your bank may require), you may be prompted to authenticate before the payment completes.
+
+## Anonymous donations
+
+LFX Crowdfunding does not currently offer a donor-selectable anonymous option. Your name and avatar will be displayed publicly on the initiative's backer list. If your donor information is unavailable at the time of processing, your name will appear as **Anonymous** on the initiative page.
+
+## After donating
+
+Once your payment is processed, you will see a confirmation screen with the initiative name and amount. From there you can share your donation on X or LinkedIn, or go to [My Donations on LFX](https://app.lfx.dev/crowdfunding/donations) to view your giving history.
+
+An email acknowledgement is sent automatically after each successful payment.

docs/user/donations/manage-donations/index.md

@@ -0,0 +1,18 @@
+---
+title: Managing Your Donations
+description: How to view your donation history and manage recurring subscriptions on LFX Crowdfunding.
+tags: [donations, history, subscriptions, recurring, cancel]
+last_updated: 2026-06-17
+display_order: 2
+intercom_collection: LFX Crowdfunding
+---
+
+Your donation history and recurring subscriptions are managed through the LFX platform. Visit [My Donations on LFX](https://app.lfx.dev/crowdfunding/donations) to access them.
+
+## Donation history
+
+The donations page lists all your past one-time and monthly donations, including the initiative name, amount, date, and payment status.
+
+## Managing recurring donations
+
+From the same page you can view all active monthly subscriptions and cancel any that you no longer want. Cancellation takes effect immediately and you will not be charged again.

docs/user/getting-started/index.md

@@ -0,0 +1,39 @@
+---
+title: Getting Started
+description: Learn how to use LFX Crowdfunding to support open source projects and communities.
+tags: [getting-started, overview, introduction]
+last_updated: 2026-06-17
+display_order: 1
+intercom_collection: LFX Crowdfunding
+---
+
+LFX Crowdfunding is the Linux Foundation's platform for funding open source initiatives. Whether you want to support a project you care about or raise funds for your own community, this guide will help you get started.
+
+## What is LFX Crowdfunding?
+
+LFX Crowdfunding connects open source projects with donors and sponsors. Projects can create fundraising initiatives to cover development costs, events, infrastructure, and more.
+
+## How it works
+
+1. **Browse initiatives** — explore active fundraising campaigns across the open source ecosystem
+2. **Choose a project** — find a project that aligns with your interests or business goals
+3. **Make a donation** — contribute one-time or set up a recurring monthly donation
+4. **Track your impact** — see how funds are being used through transparent financial reporting
+
+## For donors
+
+You can donate to any published initiative directly from its page. Donations are processed securely via Stripe and you will receive an email receipt.
+
+- One-time donations are accepted in any amount
+- Recurring (monthly) donations can be set up and cancelled at any time
+- Donations are made to the Linux Foundation, which disburses funds to projects
+
+## For projects
+
+If you manage an open source project and want to raise funds, visit the [Create an Initiative](../initiatives/create-initiative/) section to learn how.
+
+## Related sections
+
+- [Initiatives](../initiatives/) — browse and understand active campaigns
+- [Donations](../donations/) — manage your giving history
+- [Create an Initiative](../initiatives/create-initiative/) — start a fundraiser for your project or event

docs/user/initiatives/browsing-initiatives/index.md

@@ -0,0 +1,51 @@
+---
+title: Browsing Initiatives
+description: How to find and explore active fundraising campaigns on LFX Crowdfunding.
+tags: [initiatives, browse, search, filter]
+last_updated: 2026-06-17
+display_order: 1
+intercom_collection: LFX Crowdfunding
+---
+
+Go to the **Initiatives** page from the top navigation to see all active campaigns. You can search by name or filter by category.
+
+![Browse initiatives page](https://crowdfunding.linuxfoundation.org/images/docs/initiatives-browse.png)
+
+Each initiative card shows:
+
+- Project name and logo
+- Fundraising goal and amount raised so far
+- Number of supporters
+
+## Initiative detail page
+
+Click any initiative to view its full detail page.
+
+![Initiative detail page](https://crowdfunding.linuxfoundation.org/images/docs/initiatives-detail.png)
+
+The detail page includes:
+
+- **Overview** — the project's mission and how funds will be used
+- **Financials** — a breakdown of income and expenses
+- **Supporters** — a list of donors (anonymised where requested)
+
+## Initiative status
+
+| Status | Description |
+|--------|-------------|
+| **Submitted** | Application received and awaiting review |
+| **Pending** | Under review by the LFX team |
+| **Published** | Approved and active — accepting donations |
+| **Declined** | Application was not approved |
+| **Hidden** | Temporarily removed from public view |
+
+Only **Published** initiatives are visible to the public.
+
+## Donating to an initiative
+
+Use the **Donate** button on any initiative page to make a contribution. See [Donations](../../donations/) for details on the donation process.
+
+## Related sections
+
+- [Create an Initiative](../create-initiative/) — start your own campaign
+- [Backers](../../backers/) — how supporters are listed on initiative pages

docs/user/initiatives/create-initiative/index.md

@@ -0,0 +1,76 @@
+---
+title: Create an Initiative
+description: How to create a fundraising initiative for your open source project or event on LFX Crowdfunding.
+tags: [initiatives, create, fundraising, project, event]
+last_updated: 2026-06-17
+display_order: 2
+intercom_collection: LFX Crowdfunding
+---
+
+> **Sign in required** — Creating an initiative requires an [LF ID](https://openprofile.dev/) account.
+
+## Eligibility
+
+Your project must be related to or affiliated with the Linux Foundation. If you are unsure whether your project qualifies, contact your Linux Foundation programme manager.
+
+## Starting the form
+
+Click **Start a Fundraiser** in the header navigation to open the creation form. The form walks you through a series of steps.
+
+### Step 1 — Choose an initiative type
+
+![Initiative type selection](https://crowdfunding.linuxfoundation.org/images/docs/fundraising-type-select.png)
+
+Select the type that best describes your initiative:
+
+| Type | When to use |
+|------|-------------|
+| **Project** | An open source software project seeking ongoing funding |
+| **Security Audit** | A project seeking funds for a third-party security audit |
+| **Event** | A conference, meetup, or community event |
+| **General Fund** | General-purpose fundraising not tied to a specific project or event |
+
+### Step 2 — Initiative details
+
+Fill in the details for your initiative. Fields vary by type, but all types ask for:
+
+- **Name** — the public name of your campaign (max 100 characters)
+- **Elevator pitch** — a short description of what the funds will support (max 1500 characters)
+- **Topic / category** — one or more categories that describe your initiative
+- **Logo** — your project or event logo (JPG, PNG, GIF, or WebP; max 2 MB; 600×600 px recommended)
+- **Funding goal** — your target amount in USD
+
+**Project** and **General Fund** initiatives additionally ask for:
+
+- **Beneficiaries** — the people who will receive the funds (you are added automatically as the primary beneficiary)
+- **Fund distribution** — an optional breakdown of how funds will be allocated (e.g. Development, Marketing, Travel)
+
+**Security Audit** initiatives ask for:
+
+- **Repository URL** — the codebase to be audited
+- **Contact information** — primary, secondary, and technical lead contacts
+
+**Event** initiatives ask for:
+
+- **Event dates** — start and end date
+- **Registration URL** — link to where attendees can register
+- **Location** — city and country (optional)
+- **Budget distribution** — an optional breakdown across categories such as Venue, Travel, and Marketing
+
+![Initiative details form](https://crowdfunding.linuxfoundation.org/images/docs/fundraising-details-form.png)
+
+### Step 3 — Compliance and terms
+
+Before submitting, you must confirm:
+
+- **OFAC compliance** — that your initiative complies with US sanctions regulations. OFAC (the US Office of Foreign Assets Control) administers US sanctions law; you are confirming that your initiative does not involve sanctioned countries, organisations, or individuals.
+- **Terms of service** — acceptance of the LFX Platform Use Agreement
+
+## After submission
+
+Once submitted, your initiative enters a review queue. The Linux Foundation team will review your application and notify you by email once it is approved and live. You can track the status of your initiative on [My Initiatives on LFX](https://app.lfx.dev/crowdfunding/initiatives).
+
+## Related sections
+
+- [Manage Your Initiative](../manage-initiative/) — update your initiative after it is published
+- [Reimbursements](../../reimbursements/) — how to set up expense reimbursements for your team

docs/user/initiatives/index.md

@@ -0,0 +1,35 @@
+---
+title: Initiatives
+description: Learn about fundraising initiatives on LFX Crowdfunding — browse campaigns, create your own, and manage your initiative.
+tags: [initiatives, campaigns, projects, fundraising]
+last_updated: 2026-06-17
+display_order: 2
+intercom_collection: LFX Crowdfunding
+---
+
+Initiatives are fundraising campaigns created by open source projects, events, and organisations affiliated with the Linux Foundation. Each initiative has a goal, a description of how funds will be used, and a transparent record of donations received.
+
+## Initiative types
+
+| Type | Description |
+|------|-------------|
+| **Project** | An open source software project seeking ongoing community funding |
+| **Security Audit** | A project seeking funds for a third-party security audit |
+| **Event** | A conference, meetup, or community event |
+| **General Fund** | General-purpose fundraising not tied to a specific project or event |
+
+## In this section
+
+- [Browsing Initiatives](./browsing-initiatives/) — find and explore active campaigns
+- [Create an Initiative](./create-initiative/) — start a fundraiser for your project or event
+- [Manage Your Initiative](./manage-initiative/) — update details and track financial reporting
+
+## For companies and sponsors
+
+Companies looking to sponsor open source projects can donate to any published initiative directly from its page. Contact the Linux Foundation for information on sponsorship packages.
+
+## Related sections
+
+- [Donations](../donations/) — how to donate and manage your giving
+- [Backers](../backers/) — how supporters are listed on initiative pages
+- [Reimbursements](../reimbursements/) — how expense reimbursements work