dagshub-docs/mkdocs.yml

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

copyright: "© 2025 DagsHub"
nav:
  - Home: index.md
  - Quick Start:
    - quick_start/index.md
    - Hello World Colab: https://colab.research.google.com/#fileId=https%3a%2f%2fdagshub.com%2fDagsHub%2fhello-world-vision%2fraw%2fmain%2fhello-world-vision.ipynb
    - 1. Create a DagsHub Repository:
      - Creating a New Repository: quick_start/create_new_project.md
      - Connect an Existing Repository: quick_start/connect_existing_project.md
    - 2. Upload, Connect, or Version Data:
      - Upload Data: quick_start/upload_data.md
      - Connect External Storage: quick_start/connect_external_storage.md
      - Version Data: quick_start/version_data.md
    - 3. Build and Curate a Dataset:
      - Create a Dataset: quick_start/create_dataset.md
      - Add Metadata: use_cases/data_engine/enrich_datasource.md
      - Query & Filter a Dataset: use_cases/data_engine/query_and_create_subsets.md
      - Annotate Data: use_cases/annotation.md
      - AI-Assisted Labeling: use_cases/auto_labeling.md
      - Export & Augment a Dataset: use_cases/data_engine/train_model.md
    - Track Experiments: use_cases/track_ml_experiments.md
  - Use Cases:
    - use_cases/index.md
    - Curate Datasets:
        - use_cases/data_engine/index.md
        - Create a Datasource: use_cases/data_engine/connect_datasource.md
        - Version Datasets: use_cases/data_engine/version_datasets.md
        - Enrich Dataset: use_cases/data_engine/enrich_datasource.md
        - Query Dataset: use_cases/data_engine/query_and_create_subsets.md
        - Visualize Dataset: use_cases/data_engine/visualizing_datasets.md
        - Train On Your Dataset: use_cases/data_engine/train_model.md
    - Track Experiments: use_cases/track_ml_experiments.md
    - Annotate Datasets: use_cases/annotation.md
    - Deploy ML Models: use_cases/deploy_ml_model_to_cloud.md
    - Data Versioning: use_cases/data_versioning.md
    - Auto-labeling: use_cases/auto_labeling.md
    - Active Learning: use_cases/active_learning.md
    - Reproduce Experiments: use_cases/reproduce_experiment_results.md
    - Data Science Peer Review: teamwork/data_science_peer_review.md
  - Feature Guide:
      - feature_guide/index.md
      - Experiment Tracking: feature_guide/experiment_tracking.md
      - Data Engine: feature_guide/data_engine.md
      - DagsHub Storage: feature_guide/dagshub_storage.md
      - Connect External Storage: feature_guide/connect_external_storage.md
      - DagsHub Annotations: feature_guide/annotations.md
      - DagsHub Diffing: feature_guide/dagshub_diffing.md
      - DagsHub Discussions: feature_guide/dagshub_discussions.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
  - 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
    - Google Drive: integration_guide/google_drive_to_dagshub_storage.md
    - Weights & Biases: integration_guide/weights_and_biases.md
    - Hugging Face: integration_guide/hugging_face.md
    - PyCaret: integration_guide/pycaret.md
    - Giskard: integration_guide/giskard.md
    - New Relic: integration_guide/new_relic_monitoring.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
  - Tutorials:
    - tutorials/index.md
    - Hello World Vision: https://colab.research.google.com/#fileId=https%3a%2f%2fdagshub.com%2fDagsHub%2fhello-world-vision%2fraw%2fmain%2fhello-world-vision.ipynb
    - Hello World Tabular: https://colab.research.google.com/#fileId=https%3A//dagshub.com/DagsHub/Onboarding_Notebook/raw/main/hello-world/hello-world.ipynb
    - Build Data Pipelines: tutorials/build_data_pipeline.md
    - Build Custom Dataloaders: tutorials/build_custom_dataloader.md
    - Text Classification Tutorial:
        - tutorials/experiment_tutorial/index.md
        - 0. Data Exploration: tutorials/experiment_tutorial/0_data.md
        - 1. Setup: tutorials/experiment_tutorial/1_setup.md
        - 2. Data Versioning: tutorials/experiment_tutorial/2_data_versioning.md
        - 3. Experimentation: tutorials/experiment_tutorial/3_experiments.md
    - MNIST Pipeline Tutorial - Advanced:
        - tutorials/pipeline_tutorial/index.md
        - Setup: tutorials/pipeline_tutorial/setup.md
        - Defining the Pipeline: tutorials/pipeline_tutorial/pipeline.md
        - Reproducing Results: tutorials/pipeline_tutorial/experiment_repro.md
  - Troubleshooting: troubleshooting.md
  - FAQ: faq.md
  - API: api.md
  - Python Client: https://dagshub.com/docs/client
#  - All Docs: all_docs.md

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

markdown_extensions:
  - tables
  - codehilite:
      linenums: true
  - toc:
      permalink: true
  - admonition
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - footnotes
  - attr_list
  - pymdownx.mark
  - md_in_html
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
      options:
        custom_icons:
          - overrides/.icons

theme:
  features:
    - navigation.indexes
    - navigation.top
    - navigation.footer
    - content.action.edit
    - content.code.copy
  name: 'material'
  icon:
    repo: fontawesome/brands/git-alt
    edit: material/file-document-edit-outline
  custom_dir: 'theme'
  favicon: 'assets/images/favicon-black.svg'
  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
  - glightbox:
      skip_classes:
        - skip-glb

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'

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

extra:
  analytics:
    provider: google
    property: G-PSBMEYG149
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/emoticon-happy-outline
          name: This page was helpful
          data: 1
          note: >-
            Thanks for your feedback!
        - icon: material/emoticon-sad-outline
          name: This page could be improved
          data: 0
          note: >-
            Thanks for your feedback! Help us improve this page by
            creating an <a href="https://dagshub.com/DAGsHub-Official/dagshub-docs/issues" target="_blank" rel="noopener">issue in our Docs repo</a>.
  social:
    - icon: fontawesome/brands/x-twitter
      link: https://x.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
  status:
    new: Recently Added