Skip to content

docs: add common errors section to Hello World tutorial#517

Open
enoshjoseph wants to merge 3 commits into
accordproject:mainfrom
enoshjoseph:docs/add-common-errors-section
Open

docs: add common errors section to Hello World tutorial#517
enoshjoseph wants to merge 3 commits into
accordproject:mainfrom
enoshjoseph:docs/add-common-errors-section

Conversation

@enoshjoseph
Copy link
Copy Markdown

This PR adds a "Common Errors" section to the Hello World tutorial
to help users troubleshoot common issues when working with Cicero
templates and the Cicero CLI.

The section includes guidance for:

  • Missing data.json
  • Invalid or missing identifier
  • Namespace mismatch

This improves the documentation for new users experimenting with
Cicero templates.

Signed-off-by: enoshjoseph <enoshjoseph1@gmail.com>
@enoshjoseph enoshjoseph force-pushed the docs/add-common-errors-section branch from 02710f6 to 0a8ab6b Compare March 10, 2026 17:33
Copy link
Copy Markdown
Member

@mttrbrts mttrbrts left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. This troubleshooting section will be helpful for new users. Thanks!

This comment was generated by AI on behalf of @mttrbrts.

@enoshjoseph
Copy link
Copy Markdown
Author

Hi @mttrbrts , just checking if any further changes are needed from my side. Thanks!

@mttrbrts
Copy link
Copy Markdown
Member

mttrbrts commented May 9, 2026

Let's move this to a dedicated section in the reference manual? We can add a link to it here.

@enoshjoseph enoshjoseph force-pushed the docs/add-common-errors-section branch from 4bae4e4 to 302587d Compare May 11, 2026 17:38
@enoshjoseph
Copy link
Copy Markdown
Author

Hi @mttrbrts. Thanks for the feedback! I’ve moved the common errors to the reference section and added a troubleshooting link in the tutorial.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants