1
0
mirror of synced 2025-12-20 10:32:35 -05:00
Commit Graph

11 Commits

Author SHA1 Message Date
devin-ai-integration[bot]
b2afd6e91e docs: update terminology - Platform and AI agents (#70910)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: ian.alton@airbyte.io <ian.alton@airbyte.io>
Co-authored-by: octavia-bot[bot] <108746235+octavia-bot[bot]@users.noreply.github.com>
2025-12-13 22:26:24 +00:00
Ian Alton
e57ab8cb0c docs(ai-agents): Add AI connector tutorials and Agent engine positioning (#70461)
Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Alexandre Girard <alexandre@airbyte.io>
2025-12-12 16:24:55 -08:00
devin-ai-integration[bot]
6d8ed4ac77 Create Developers Docusaurus instance with moved documentation pages (#69264)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: ian.alton@airbyte.io <ian.alton@airbyte.io>
2025-11-12 12:02:57 -08:00
Ian Alton
46abc20666 Docs plus plan (#68154)
Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2025-11-05 15:08:56 -08:00
Ian Alton
4f97ee2dab docs: update plan names in docs content (#67573)
## What
<!--
* Describe what the change is solving. Link all GitHub issues related to
this change.
-->

This pull request updates plan names across most of the Documentation so
they're consistent with our current plan names.

## How
<!--
* Describe how code changes achieve the solution.
-->

My original plan was to convert free text to MDX variables so we only
had to make future updates to names in one place. While broadly
successful, there were numerous edge cases that made rolling this out
almost impossible. There were too many ways and places you couldn't use
variables due to a variety of limitations in Docusaurus and Airbyte's
internal MarkDown processor. Explaining how to properly use them made me
realize how prohibitively insufficient this was. In the end, I opted to
return to using free text for plan names.

Scope is now broadly reduced. This PR:

- Converts remaining instances of old plan names to new plan names. In
most cases, I replaced old plan names with new plan names directly. In
some cases, sentences were rewritten to make a bit more sense or be more
maintainable in the future.

- Removes previously added preprocessor variables from Docusaurus
configuration.

- Update Vale styles or various artifacts of content based on linter
findings.

## Review guide
<!--
1. `x.py`
2. `y.py`
-->

Spot check updated pages to ensure plan names appear appropriately. It's
probably not necessary to check every single instance in detail.

For Platform docs, changes only apply to the Next/Cloud version. After
merging, I'll regenerate 2.0 docs based on this. 1.8 and before won't be
updated.

## User Impact
<!--
* What is the end result perceived by the user?
* If there are negative side effects, please list them. 
-->

People can see correct plan names in docs content.

## Can this PR be safely reverted and rolled back?
<!--
* If unsure, leave it blank.
-->
- [x] YES 💚
- [ ] NO 

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2025-10-17 17:34:29 -07:00
devin-ai-integration[bot]
bb7b7bdba7 docs: Convert home page to React component with improved layout (#68101)
## What

Converts the Airbyte documentation home page from a static markdown page
to a dynamic React-based page with improved visual design and
navigation. Moves "Why Airbyte?" content from home page to platform
page.

Requested by ian.alton@airbyte.io in session:
https://app.devin.ai/sessions/6441f0af52ff4f0bb03a55c3fd4252c9

## How

**Architecture Change:**
- Disabled the default Docusaurus docs plugin at root route (`docs:
false`)
- Enabled pages plugin to support standalone React pages
- Deleted `/docs/home/readme.md` and `sidebar.js`
- Created new React component at `/docusaurus/src/pages/index.js`

**New Home Page Features:**
1. **Hero Section**: Purple background (adapts to dark mode) with title,
description, and Arcade demo embed
2. **Navigation Grid**: 6 cards with custom SVG icons:
   - Platform → `/platform/`
   - Connectors → `/integrations/`
   - Release Notes → `/release_notes/`
   - AI Agents → `/ai-agents/`
   - Developers → `/platform/api-documentation`
   - Community and Support → `/platform/community/getting-support`
3. Fully responsive design (3 columns → 2 columns → 1 column)
4. Fast hover transitions (0.2s ease-out)
5. Empty page title to use site-level title (avoids "Airbyte
Documentation | Airbyte Docs" duplication)

**Content Migration:**
- Moved "Why Airbyte?" section with badges from home page to
`/docs/platform/readme.md`

## Review guide

**Critical files (routing change):**
1. `docusaurus/docusaurus.config.js` - Verify the docs plugin disable
and pages plugin enable
2. `docusaurus/src/pages/index.js` - New home page React component,
check all navigation links

**Styling:**
3. `docusaurus/src/pages/index.module.css` - Check CSS variables are
defined:
   - `--color-grey-40`
   - `--color-blue-30`
   - `--ifm-color-primary-lightest`
   - Responsive breakpoints at 996px and 640px

**Content:**
4. `docs/platform/readme.md` - Verify "Why Airbyte?" section placement
makes sense here
5. Deleted files (`docs/home/readme.md`, `sidebar.js`) - Confirm no
other references exist

**Testing checklist:**
- [x] Navigate to `/` and verify new home page renders
- [x] Test all 6 navigation card links
- [x] Toggle dark/light mode
- [x] Test responsive design at tablet (996px) and mobile (640px)
breakpoints
- [x] Verify Arcade embed loads correctly
- [x] Check `/platform/` page has "Why Airbyte?" section
- [x] Verify page title doesn't show duplicate "Airbyte Documentation"

**Accessibility concerns:**
- SVG icons lack aria-labels - should be addressed in follow-up

## User Impact

Users will see a modernized home page with:
- Prominent hero section with purple Airbyte branding
- Clear navigation cards with icons and descriptions  
- Improved mobile experience
- Faster hover interactions

**Potential negative impacts:**
- "Why Airbyte?" content moved from home to platform page - users
expecting it on home page won't find it there
- Old bookmarks to `/docs/home` may break (though likely redirected by
Docusaurus)
- Page title behavior changed (empty title uses site title)

## Can this PR be safely reverted and rolled back?

- [x] YES 💚

This is a pure UI change with no backend or data modifications. The old
markdown file can be restored from git history. All navigation links
point to existing routes.

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: ian.alton@airbyte.io <ian.alton@airbyte.io>
2025-10-15 16:48:42 -07:00
Lucas Leadbetter
9ab8811fc0 updating trial length docs per recent changes (#67513)
## What

Trial lengths were recently updated to 30 days from 14 days, so updating
docs to reflect this. I can't seem to find any other references to that
length in the docs, so this should be the only other references.

## How

Updated docs. 

## User Impact

Just minor docs update. 

## Can this PR be safely reverted and rolled back?
<!--
* If unsure, leave it blank.
-->
- [x] YES 💚
- [ ] NO 

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2025-10-08 07:46:16 -07:00
Ian Alton
592659f902 Update plan names on the platform home page. (#66624) 2025-09-23 16:49:43 -07:00
Matteo Palarchio
ea51a0e3dd Docs cloud enterprise (#65578)
Co-authored-by: ian-at-airbyte <ian.alton@airbyte.io>
Co-authored-by: Alexandre Cuoci <Hesperide@users.noreply.github.com>
2025-08-29 01:32:02 +00:00
Ian Alton
58240f15fc Add new cases to handle folders without a path (#58625) 2025-04-24 20:50:06 -04:00
Ian Alton
01cd16654e 11059 multi-instance, versioned docs (#58095)
Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2025-04-24 02:58:09 +03:00