search

Redocly / developer-portal-starter

Starter template for the Redocly developer portal
https://redoc.ly
Other
64 stars 101 forks source link

Incorrect error messages: existing files "Could not find" #212

Open WaterSibilantFalling opened 2 years ago

WaterSibilantFalling commented 2 years ago

Incorrect error messages:

ERROR

Could not find page: openapi/user-authorization.yaml.

when the file exists.

The redocly site does not build properly - most of it does not work.

Unfortunately, the error message is completely uninformative

image

WaterSibilantFalling commented 2 years ago

siteConfig.yaml

meta:
  title: Plexure API Portal
  description: The one-stop-shop for Plexure API documentation
  siteUrl: https://portal-demo.redoc.ly

logo: ./images/logo.png

toc:
  enable: true

oasDefinitions:
  some_tag: './openapi/another-api.yaml'
  another_tag: './openapi/user-authorization.yaml'
  # $ref: './api-definitions.yaml'
stylesheets:
  - https://fonts.googleapis.com/css?family=Roboto:300,400,600,700
  - https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700&display=swap

nav:
  - label: Plexure Repos
    icon: ./images/redocly-icon-white.png
    href: https://dev.azure.com/vmob/New%20Plexure/_git/vmob-backend/
  - search: true

footer:
  copyrightText: Copyright © Redocly 2019-2020. All right reserved.

snippet from sidebars.yaml

  - group: Core Infrastructure
    expanded: true
    pages:
      - group: Another API
        expanded: true
        pages:
          - page: openapi/another-api.yaml
      - group: User Authorization Service
        expanded: true
        pages:
          - label: Overview
            page: "developer-portal/Core Infrastructure/User Authorization Service/overview.md" 
          - page: openapi/user-authorization.yaml
  - group: Data Enablement
    expanded: true
  - group: Insights Platform
    expanded: true
  - group: Integrations
Orest-Yastremskyy commented 2 years ago

Hi @WaterSibilantFalling,

Thanks for letting us know.

Is this the same portal as in #209?

For us to have a closer look at this issue, I would kindly ask you to share your Developer portal.

Looking forward to your reply.

Orest-Yastremskyy commented 2 years ago

You can share it with me privately (via email (orest@redocly.com) or access to the private repo), if sharing it here is not desirable.

Thanks!

WaterSibilantFalling commented 2 years ago

Is this the same portal as in https://github.com/Redocly/developer-portal-starter/issues/209?

Yes.

You can share it with me privately (via email (orest@redocly.com)

Yes, have emailed the Developer Portal directory tree to you.

Orest-Yastremskyy commented 2 years ago

Thank you for sharing this.

Let us proceed with further communication via email.