dagshub-docs/mkdocs.yml

site_name: DagsHub Docs
site_description: 'DagsHub Documentation - Learn how to use DagsHub and improve you data science workflow'
site_dir: 'build/docs'
site_url: 'https://dagshub.com/docs'

copyright: "© 2023 DagsHub"
nav:
  - Home: index.md
  - Quick Start:
    - quick_start/index.md
    - Set up DagsHub: quick_start/set_up_dagshub.md
    - Version Data and Code: quick_start/version_data_and_code.md
  - Feature Guide:
      - feature_guide/index.md
      - DagsHub Storage: feature_guide/dagshub_storage.md
      - Direct Data Access: feature_guide/direct_data_access.md
      - Experiment Table: feature_guide/discovering_experiments.md
      - DagsHub Tracking: feature_guide/git_tracking.md
      - DagsHub Annotations: feature_guide/annotations.md
      - DagsHub Diffing: feature_guide/dagshub_diffing.md
      - DagsHub Discussions: feature_guide/dagshub_discussions.md
      - DagsHub Reports: feature_guide/reports.md
      - DagsHub Pipelines: feature_guide/pipeline.md
      - Data Science Pull Requests: feature_guide/data_science_pull_requests.md
      - DagsHub Topics: feature_guide/topics.md
      - DagsHub Templates: feature_guide/project_templates.md
      - DagsHub Automation: feature_guide/automation.md
      - Reproduce Results: feature_guide/reproducing_results.md
      - Data Merging: feature_guide/data_merging.md
  - Integration Guide:
    - integration_guide/index.md
    - GitHub: integration_guide/github.md
    - Google Colab: integration_guide/google_colab.md
    - DVC: integration_guide/dvc.md
    - MLflow: integration_guide/mlflow_tracking.md
    - Jenkins: integration_guide/jenkins.md
    - Label Studio: integration_guide/label_studio.md
    - External Storage: integration_guide/set_up_remote_storage_for_data_and_models.md
    - External Git Server: integration_guide/connect_a_git_server_to_dagshub.md
    - Webhooks: integration_guide/webhook.md
    - New Relic: integration_guide/new_relic_monitoring.md
  - FAQ: faq.md
  - Troubleshooting: troubleshooting.md
  - Tutorials:
    - Basic Tutorial:
        - experiment_tutorial/index.md
        - 0. Data Exploration: experiment_tutorial/0_data.md
        - 1. Setup: experiment_tutorial/1_setup.md
        - 2. Data Versioning: experiment_tutorial/2_data_versioning.md
        - 3. Experimentation: experiment_tutorial/3_experiments.md
    - DagsHub Annotations: tutorial/label_studio_tutorial.md
    - Pipeline Tutorial - Advanced:
        - tutorial/index.md
        - Setup: tutorial/setup.md
        - Defining the Pipeline: tutorial/pipeline.md
        - Experimenting and Reproducibility: tutorial/experiment_repro.md
  - Workshops:
      - workshops/index.md
      - Interactive Session: workshops/interactive_session.md
      - MLflow Crash Course: workshops/mlflow_crash_course.md
      - DVC and DDA: workshops/dvc_and_dda.md
      - Label Studio: workshops/label_studio.md
      - Generative AI: workshops/generative_ai_comics_strip.md
      - Google Drive to DagsHub: workshops/google_drive_to_dagshub_storage.md
  - API: api.md

edit_uri: https://dagshub.com/DagsHub-Official/dagshub-docs/_edit/main/docs/

markdown_extensions:
  - codehilite:
      linenums: true
  - toc:
      permalink: true
  - admonition
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - footnotes
  - attr_list
  - pymdownx.mark
  - tables

google_analytics: [true, true]

theme:
  features:
    - navigation.indexes
    - navigation.top
  name: 'material'
  icon:
    repo: fontawesome/brands/git-alt
    edit: material/file-document-edit-outline
  custom_dir: 'theme'
  favicon: 'assets/images/favicon.png'
  logo: 'assets/images/logo.svg'
  palette:
    - scheme: default
      primary: 'teal'
      accent: 'teal'
      toggle:
        icon: material/toggle-switch
        name: Switch to dark mode
    - scheme: slate
      primary: 'teal'
      accent: 'teal'
      toggle:
        icon: material/toggle-switch-off-outline
        name: Switch to light mode
  font:
    text: 'Inter'
    code: 'Roboto Mono'
  navigation_depth: 4

plugins:
  - search:
      separator: '[\s\-\.]+'
      lang:
        - en

extra_css:
  - 'assets/stylesheets/header.css'
  - 'assets/stylesheets/footer.css'
  - 'assets/stylesheets/extra.css'
  - 'assets/stylesheets/swagger-ui.css'
  - 'assets/stylesheets/custom-search.css'
  - 'assets/stylesheets/dark-mode-toggle.css'
  - 'assets/stylesheets/prev-next-buttons.css'

extra_javascript:
  - 'assets/javascripts/redirects.js'
  - 'assets/javascripts/header.js'
  - 'js/jquery-3.6.0.min.js'

extra:
  social:
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/TheRealDagsHub
    - icon: fontawesome/brands/youtube
      link: https://www.youtube.com/channel/UCeuZrCdpIY69XNWqn9OeSYQ
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/dagshub
    - icon: fontawesome/brands/discord
      link: https://discord.com/invite/9gU36Y6