-
  Base:
    -
      name: Design of Shrine
      path: design.md
    -
      name: Retrieving Uploads
      path: retrieving_uploads.md
    -
      name: Using Attacher
      path: attacher.md

  Features:
    -
      name: Direct Uploads to S3
      path: direct_s3.md
    -
      name: Extracting Metadata
      path: metadata.md
    -
      name: File Processing
      path: processing.md
    -
      name: File Validation
      path: validation.md

  Extras:
    -
      name: Multiple Files
      path: multiple_files.md
    -
      name: Securing Uploads
      path: securing_uploads.md
    -
      name: Testing with Shrine
      path: testing.md

-
  Migrating:
    -
      name: Changing Derivatives
      path: changing_derivatives.md
    -
      name: Changing Location
      path: changing_location.md
    -
      name: Changing Storage
      path: changing_storage.md

  Extending:
    -
      name: Writing a Plugin
      path: creating_plugins.md
    -
      name: Writing a Persistence Plugin
      path: creating_persistence_plugins.md
    -
      name: Writing a Storage
      path: creating_storages.md

  Comparison:
    -
      name: Advantages of Shrine
      path: advantages.md
    -
      name: Shrine for CarrierWave Users
      path: carrierwave.md
    -
      name: Shrine for Paperclip Users
      path: paperclip.md
    -
      name: Shrine for Refile Users
      path: refile.md

-
  Base:
    -
      name: Design of Shrine
      path: design.md
    -
      name: Retrieving Uploads
      path: retrieving_uploads.md
    -
      name: Using Attacher
      path: attacher.md

  Features:
    -
      name: Direct Uploads to S3
      path: direct_s3.md
    -
      name: Extracting Metadata
      path: metadata.md
    -
      name: File Processing
      path: processing.md
    -
      name: File Validation
      path: validation.md

  Extras:
    -
      name: Multiple Files
      path: multiple_files.md
    -
      name: Securing Uploads
      path: securing_uploads.md
    -
      name: Testing with Shrine
      path: testing.md
    -
      name: Upgrading to Shrine 3.x
      path: upgrading_to_3.md

-
  Migrating:
    -
      name: Changing Derivatives
      path: changing_derivatives.md
    -
      name: Changing Location
      path: changing_location.md
    -
      name: Changing Storage
      path: changing_storage.md

  Extending:
    -
      name: Writing a Plugin
      path: creating_plugins.md
    -
      name: Writing a Persistence Plugin
      path: creating_persistence_plugins.md
    -
      name: Writing a Storage
      path: creating_storages.md

  Comparison:
    -
      name: Advantages of Shrine
      path: advantages.md
    -
      name: Shrine for CarrierWave Users
      path: carrierwave.md
    -
      name: Shrine for Paperclip Users
      path: paperclip.md
    -
      name: Shrine for Refile Users
      path: refile.md

Add the upgrading guide to the website
Add the upgrading guide to the website
