Skip to content

No docs page generated for OpenAPI spec "name" element even when .md file added to versions file #6978

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mmrj opened this issue May 5, 2025 · 0 comments

Comments

@mmrj
Copy link

mmrj commented May 5, 2025

Which Fern component?

Fern CLI

How urgent is this?

P2 - Medium (Would be helpful)

What's the issue?

In our fern/openapi directory, we have a content/example.md file, and we've added that to our fern/versions/example-version.yml file like so:

- example:
              summary: ../openapi/content/example.md

However, no page is generated. We suspect this is because in our OpenAPI spec, there the entry is:

{
    "name": "Example",
    "description": "<contents of content/example.md>"
},

but there are no endpoints for this tag, just a description. We'd like to the topic to appear anyway, even if it has not sub-pages for individual endpoints, and think that it should be appearing based on our OpenAPI spec and the way that we've copied info from the spec into the fern/openapi/content/ folder and set up the fern/versions/example-version.yml file.

The error that appears when we run fern docs dev is:

Subpackage example not found in 08ac3b1f-0799-40a8-bde0-89b1404af84e, treating it as a section

Fern CLI & Generator Versions

Fern CLI version 0.60.9

Workaround

No workarounds discovered.

Are you interested in contributing a fix?

No

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

1 participant