Welcome to the Bluefly.io code repository. By logging in, you agree to comply with our terms of service and code of conduct.

Skip to content

Migrate All Documentation to GitLab Wiki

Objective

Move all narrative documentation from markdown files to GitLab Wiki for collaborative editing and evergreen content management.

Branding Documentation → Wiki

Core Pages

  • `branding/BRAND_GUIDELINES.md` → Wiki: "Brand Guidelines"
  • `branding/BRAND_ASSETS.md` → Wiki: "Brand Assets Library"
  • `branding/accessibility.md` → Wiki: "Accessibility Standards"
  • `branding/resources.md` → Wiki: "Design Resources"
  • `branding/IMPLEMENTATION.md` → Wiki: "Implementation Guide"

Design Foundations

  • `branding/foundations/color.md` → Wiki: "Design Foundations/Color System"
  • `branding/foundations/typography.md` → Wiki: "Design Foundations/Typography"
  • `branding/foundations/icons.md` → Wiki: "Design Foundations/Icons"
  • `branding/foundations/layout.md` → Wiki: "Design Foundations/Layout"
  • `branding/foundations/motion.md` → Wiki: "Design Foundations/Motion"

API Documentation → Wiki

  • `openapi/README.md` → Wiki: "OpenAPI Registry Guide"
  • `apidog-sync/README.md` → Wiki: "Apidog Integration" (note: service moved)
  • `apidog-sync/docs/*.md` → Wiki subsection
  • `design-system-api/README.md` → Wiki: "Design System API" (note: service moved)
  • `design-system-api/docs/*.md` → Wiki subsection

Archive Migrated Files

  • Move all migrated .md files to `__DELETE_LATER/docs-archive/`
  • Keep README.md in root (update to reflect new structure)
  • Document migration in README with links to Wiki

Create GitLab Issues for Action Items

  • Scan all documentation for TODO, FIXME, Action items
  • Extract and create GitLab Issues with appropriate labels
  • Link issues to Epic #1
  • Add context from original docs

Wiki Structure

``` technical-guide Wiki/ ├── Home ├── Brand Guidelines │ ├── Overview │ ├── Color System │ ├── Typography │ ├── Logo Usage │ └── Accessibility ├── Design Foundations │ ├── Color │ ├── Typography │ ├── Icons │ ├── Layout │ └── Motion ├── OpenAPI Registry │ ├── Overview │ ├── Registry Structure │ └── Contributing Specs └── Integrations ├── Apidog └── Design System API ```

Commands

Use `buildkit gitlab-wiki` command for wiki management

Related

  • Epic: #1
  • Previous: #5 (registry index)
  • Next: #7 (extract design tokens)

Rationale

  • Wiki is collaborative and easy to edit
  • Evergreen content lives separate from code
  • No markdown dumps in repositories
  • GitLab Issues for actionable items