Skip to content

Docs: cms-agilitycms #52867

Open
Open
@CraigBC

Description

What is the improvement or update you wish to see?

The documentation for AgilityCMS urgently requires comprehensive enhancements. The existing materials impede developers' experiences by necessitating conjectures about the correct steps - this viewpoint comes from a user familiar with the AgilityCMS system. There is an evident disparity between the terminology used in the official documents and that on the AgilityCMS platform itself. This could potentially deter new developers, causing them to abandon their efforts prematurely. Although I've strictly adhered to the NextJS example code and diligently followed the provided tutorial (to the best of my ability given the circumstances), I cannot get this example to work. There is no feedback that even suggests how to fix the error (and I'm guessing even if I fix the "HeroPost" problem, I anticipate more errors to come...)

Far too complicated. Not a positive developer experience.

Is there any context that might help us understand?

Error:

Agility CMS => Fetching sitemap for getAgilityPaths...
Agility CMS => Getting page props for '/'...
- error Error: Could not find a component with the name HeroPost. Tried searching:
        /xxxxx/components/hero-post.tsx',
        /xxxxx/lib/components/hero-post.tsx',
        /xxxxx/components/HeroPost.tsx',
        /xxxxx/lib/components/HeroPost.tsx'.

....it's literally right there under xxxxx/components/hero-post.tsx?

Does the docs page already exist? Please link to it.

https://github.com/vercel/next.js/blob/canary/examples/cms-agilitycms/README.md

Metadata

Assignees

No one assigned

    Labels

    examplesIssue was opened via the examples template.good first issueEasy to fix issues, good for newcomers

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions