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: "© 2022 DagsHub"
nav:
  - Docs Home: index.md
  - Get Started:
    - Get Started Overview: getting_started/overview.md
    - Create a Project on DagsHub: getting_started/create_a_dagshub_project.md
    - Version Code and Data: getting_started/version_code_and_data.md
    - Track Experiments: getting_started/track_experiments.md
    - Explore a New Hypothesis: getting_started/explore_a_new_hypothesis.md
  - Feature Guide:
      - Feature Guide Overview: feature_guide.md
      - DagsHub Storage: feature_guide/dagshub_storage.md
      - DagsHub Annotations: feature_guide/annotations.md
      - DagsHub Tracking: feature_guide/git_tracking.md
      - Experiment Table: feature_guide/discovering_experiments.md
      - DagsHub Diffing: feature_guide/dagshub_diffing.md
      - DagsHub Discussions: feature_guide/dagshub_discussions.md
      - DagsHub Reports: feature_guide/reports.md
      - DagsHub Pipeline: 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 Overview: integration_guide.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:
        - Overview: experiment_tutorial/overview.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:
        - Overview: tutorial/overview.md
        - Setup: tutorial/setup.md
        - Defining the Pipeline: tutorial/pipeline.md
        - Experimenting and Reproducibility: tutorial/experiment_repro.md
    - Google Drive to DagsHub: tutorial/google_drive_to_dagshub_storage.md
  - Workshops:
      - Interactive Session: workshops/interactive_session.md
      - Production-oriented Work: workshops/production_oriented_work.md
      - Data Science Teamwork with Git: workshops/effective_data_science_teamwork_using_git.md
  - Feature Updates: feature_updates.md
  - API: api.md

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

google_analytics: [true, true]

theme:
  name: 'material'
  icon:
    repo: fontawesome/brands/git-alt
  custom_dir: 'theme'
  favicon: 'assets/images/favicon.png'
  logo: 'assets/images/logo.svg'
  palette:
    primary: 'teal'
    accent: 'teal'
    scheme: 'slate'
  font:
    text: 'Lato'
    code: 'Roboto Mono'
  navigation_depth: 4

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

extra_css:
  - 'assets/stylesheets/extra.css'
  - 'assets/stylesheets/swagger-ui.css'

extra_javascript:
  - 'assets/javascripts/redirects.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