Docs: cms-agilitycms

[CraigBC]

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

[shyampathade]

Can you assign it to me please ?

[anirudhpratap345]

import HeroPost from '../path/to/components/HeroPost';
Replace '../path/to/components/' with the actual relative path to the directory where the component is located.

[naolmelesse]

hello @balazsorban44 , can I work on this?

[balazsorban44]

Feel free to just open a PR and reference this issue. It's generally not required to ask for permission. 🙂

[naolmelesse]

Feel free to just open a PR and reference this issue. It's generally not required to ask for permission. 🙂

I am new to this. Thanks. 🙂