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: "© 2023 DagsHub"
nav:
  - Home: index.md
  - Quick Start:
    - quick_start/index.md
    - Hello World Colab: https://colab.research.google.com/#fileId=https%3A//dagshub.com/DagsHub/Onboarding_Notebook/raw/main/hello-world/hello-world.ipynb
    - Create a new Project: quick_start/create_new_project.md
    - Connect an Existing Project: quick_start/connect_existing_project.md
    - Manage Datasets: use_cases/data_engine/index.md
    - Track Experiments: use_cases/track_ml_experiments.md
  - Use Cases:
    - use_cases/index.md
    - Curate Datasets:
        - use_cases/data_engine/index.md
        - Connect a Datasource: use_cases/data_engine/connect_datasource.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
    - Version Datasets and Code:
      - use_cases/version_data_and_code/index.md
      - Version Datasets: use_cases/version_data_and_code/version_datasets.md
      - Version Data Files: use_cases/version_data_and_code/version_data_files.md
      - Version Code: use_cases/version_data_and_code/version_code.md
    - Track ML Experiments: use_cases/track_ml_experiments.md
    - Annotate Datasets: use_cases/annotation.md
    - Auto-labeling: use_cases/auto_labeling.md
    - Active Learning: use_cases/active_learning.md
    - Reproduce ML Experiments: use_cases/reproduce_experiment_results.md
    - Build Data Pipelines: use_cases/build_data_pipeline.md
    - Build Custom Dataloaders: use_cases/build_custom_dataloader.md
    - Deploy ML Models: use_cases/deploy_ml_model_to_cloud.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 Data Storage:
        - feature_guide/dagshub_storage/index.md
        - Upload Data: feature_guide/dagshub_storage/upload_data.md
        - Stream & Download Data: feature_guide/dagshub_storage/data_streaming.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:
    - 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
    - Pipeline Tutorial - Advanced:
        - tutorial/index.md
        - Setup: tutorial/setup.md
        - Defining the Pipeline: tutorial/pipeline.md
        - Reproducing Results: tutorial/experiment_repro.md
  - Troubleshooting: troubleshooting.md
  - FAQ: faq.md
  - API: api.md
  - Python Client: 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