developer-portal-starter icon indicating copy to clipboard operation
developer-portal-starter copied to clipboard

Incorrect error messages: existing files "Could not find"

Open WaterSibilantFalling opened this issue 3 years ago • 5 comments

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

  • from what file?
  • what stage of building the site?
  • what process could not find the existing file?
  • what was found?

image

WaterSibilantFalling avatar May 21 '22 16:05 WaterSibilantFalling

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

WaterSibilantFalling avatar May 21 '22 17:05 WaterSibilantFalling

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 avatar May 23 '22 10:05 Orest-Yastremskyy

You can share it with me privately (via email ([email protected]) or access to the private repo), if sharing it here is not desirable.

Thanks!

Orest-Yastremskyy avatar May 23 '22 10:05 Orest-Yastremskyy

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 ([email protected])

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

WaterSibilantFalling avatar May 23 '22 19:05 WaterSibilantFalling

Thank you for sharing this.

Let us proceed with further communication via email.

Orest-Yastremskyy avatar May 24 '22 09:05 Orest-Yastremskyy