Skip to content

fix: homepage layout, broken links, and Ergo-to-TypeScript migration#507

Merged
mttrbrts merged 1 commit into
accordproject:mr-remove-ergofrom
ChinmayaBiswal7:fix/homepage-and-broken-links
Mar 6, 2026
Merged

fix: homepage layout, broken links, and Ergo-to-TypeScript migration#507
mttrbrts merged 1 commit into
accordproject:mr-remove-ergofrom
ChinmayaBiswal7:fix/homepage-and-broken-links

Conversation

@ChinmayaBiswal7

@ChinmayaBiswal7 ChinmayaBiswal7 commented Mar 4, 2026

Copy link
Copy Markdown
Contributor

Closes #506

Changes

  • Homepage Layout: Added full CSS styling to custom.css for hero gradient, buttons, and features section.
  • Content Updates: Replaced Ergo with TypeScript / Template Logic card on the homepage.
  • Logic Section: Updated Logic block with TypeScript description and new template_logic.png image.
  • Broken Links: Fixed model-concerto link to point to external Concerto docs.
  • Broken Images: Fixed 4 broken image paths in started-hello.md and tutorial-library.md using relative paths.
  • Tutorial Migration: Updated tutorials (templates, library, and create) to use logic.ts and vitest instead of Ergo and cucumber.

Flags

@ChinmayaBiswal7
fix: homepage layout, broken links, and Ergo-to-TypeScript migration
38fbe78 
- Fix homepage heroCover hero section styling in custom.css (v3 compatibility)
- Remove Ergo as primary feature; replace with TypeScript/Template Logic card
- Update Logic ContentBlock: Ergo description -> TypeScript, ergo.png -> template_logic.png
- Fix broken /docs/model-concerto internal links -> concerto.accordproject.org/docs/intro
- Fix broken image paths in started-hello.md (3x) and tutorial-library.md (1x)
  - /docs/assets/basic/* -> ./assets/basic/* (Docusaurus v3 relative paths)
- Fix empty link [fixed rate loan]() -> https://playground.accordproject.org
- Update tutorial-templates.md: logic.ergo -> logic.ts, Ergo code -> TypeScript
- Update tutorial-library.md: directory structure logic.ergo -> logic.ts
- Update tutorial-create.md: generator output, test runner (cucumber->vitest),
  and Edit Logic section now documents TypeScript pattern

References: accordproject/cicero-template-library#484
Signed-off-by: ChinmayaBiswal7 <chinmayabiswal44@gmail.com>
Signed-off-by: ChinmayaBiswal7 <chinmayabiswal777@gmail.com>
@ChinmayaBiswal7
ChinmayaBiswal7 force-pushed the fix/homepage-and-broken-links branch from f2ceaec to 38fbe78 Compare March 4, 2026 13:29
@yuanglili yuanglili mentioned this pull request Mar 6, 2026
Closed
5 tasks
mttrbrts
mttrbrts approved these changes Mar 6, 2026
View reviewed changes

@mttrbrts mttrbrts left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is a big improvement! Thank you for your hard work @ChinmayaBiswal7!

@mttrbrts
mttrbrts merged commit 6547d9e into accordproject:mr-remove-ergo Mar 6, 2026
2 checks passed
@ChinmayaBiswal7

ChinmayaBiswal7 commented Mar 6, 2026

Copy link
Copy Markdown
Contributor Author

Thank you so much, @mttrbrts! It was a great learning experience working on this. I'm really glad I could help improve the documentation for the v3 migration.

Let me know if there are any other areas or related issues I can help out with next!

@ChinmayaBiswal7
ChinmayaBiswal7 deleted the fix/homepage-and-broken-links branch March 6, 2026 21:19
@ChinmayaBiswal7 ChinmayaBiswal7 mentioned this pull request Mar 7, 2026
Closed
@ChinmayaBiswal7

ChinmayaBiswal7 commented Mar 8, 2026

Copy link
Copy Markdown
Contributor Author

@mttrbrts Thank you again for reviewing and merging this PR! If possible, could I also be added to the All Contributors list for documentation?

@yuanglili yuanglili mentioned this pull request Mar 12, 2026
Closed
9 tasks
mttrbrts added a commit that referenced this pull request Apr 26, 2026
@mttrbrts @ChinmayaBiswal7 @yuanglili
fix(docs): remove Ergo references and modernise documentation (#505)
a4c6a64 
* wip

* fix link top position

* fix: homepage layout, broken links, and Ergo-to-TypeScript migration (#507)

- Fix homepage heroCover hero section styling in custom.css (v3 compatibility)
- Remove Ergo as primary feature; replace with TypeScript/Template Logic card
- Update Logic ContentBlock: Ergo description -> TypeScript, ergo.png -> template_logic.png
- Fix broken /docs/model-concerto internal links -> concerto.accordproject.org/docs/intro
- Fix broken image paths in started-hello.md (3x) and tutorial-library.md (1x)
  - /docs/assets/basic/* -> ./assets/basic/* (Docusaurus v3 relative paths)
- Fix empty link [fixed rate loan]() -> https://playground.accordproject.org
- Update tutorial-templates.md: logic.ergo -> logic.ts, Ergo code -> TypeScript
- Update tutorial-library.md: directory structure logic.ergo -> logic.ts
- Update tutorial-create.md: generator output, test runner (cucumber->vitest),
  and Edit Logic section now documents TypeScript pattern

References: accordproject/cicero-template-library#484

Signed-off-by: ChinmayaBiswal7 <chinmayabiswal44@gmail.com>
Signed-off-by: ChinmayaBiswal7 <chinmayabiswal777@gmail.com>

* fix: tutorial type names, model path and Node.js URL (#510)

Signed-off-by: nonononoonononon <yuangli971@gmail.com>

* fix(CONTRIBUTING): remove broken anchor links and update outdated references

- Remove TOC entries for non-existent sections (Updating Documentation, Technical Documentation)
- Remove broken contribute.cla, contribute.updating, contribute.techdocs link defs
- Remove broken developers.pullrequest link def (DEVELOPERS.md has no #pullrequest anchor)
- Update PR submission paragraph to remove stale CLA/Travis references; mention DCO

Closes #515

Signed-off-by: Matt Roberts <code@rbrts.uk>

* fix(docs): replace Ergo references with TypeScript/Concerto equivalents

- Change code fence labels from `ergo` to `concerto` in all files where
  the block contains Concerto model syntax (not Ergo language):
  markup-templatemark.md (12 blocks), accordproject-template.md,
  accordproject-slc.md, tutorial-templates.md, tutorial-studio.md (2 blocks),
  ref-errors.md, example-eatapple.md
- Convert the Ergo logic example in example-eatapple.md to TypeScript
  using the TemplateLogic class pattern
- Rename 'Ergo Formulas' section in markup-ciceromark.md to
  'Template Formulas' and update the description
- Update tutorial-studio.md prose: remove 'in Ergo', update 'Ergo tab'
  to 'Logic tab', update 'Ergo engine' to 'template engine'; add note
  that the tutorial covers legacy Ergo-based templates
- Intentional Ergo reference files (ref-ergo-*, logic-*.md,
  ergo-tutorial.md, ref-migrate-*.md) are left unchanged

Signed-off-by: Matt Roberts <code@rbrts.uk>

* fix(docs): replace 'ERGO' with 'TypeScript' in template triangle images

Updated template.png and template_logic.png in-place using Pillow:
- Painted over the 'ERGO' subtitle at the LOGIC vertex
- Drew 'TypeScript' in the same position using Arial Bold at
  matching size and navy colour (#5 0C 40)

Closes techdocs-4tw

Signed-off-by: Matt Roberts <code@rbrts.uk>

* fix(docs): replace 'ERGO' with 'TypeScript' in template_text and template_model thumbnails

Same Pillow patch applied to the remaining two thumbnail images
(template_text.png, template_model.png) which share the same mini
triangle layout as template_logic.png.

Signed-off-by: Matt Roberts <code@rbrts.uk>

* chore: add AGENTS.md and ignore Dolt database files

Added beads/bd agent instructions as AGENTS.md.
Updated .gitignore to exclude .dolt/ and *.db files
created by bd init.

Signed-off-by: Matt Roberts <code@rbrts.uk>

* fix(docs): replace eat-apples example with late payment clause

Rewrote example-eatapple.md to use a more representative
late payment clause example with TypeScript logic.
Also added ref-migrate-concerto-3.0-4.0.md migration guide.

Signed-off-by: Matt Roberts <code@rbrts.uk>

* fix(website): update homepage, footer, and assets

- Updated homepage hero text and Features section with logo images
  for TypeScript and Concerto
- Disabled stale 'Who's Using This?' showcase section
- Removed outdated footer links (Stack Overflow, Twitter, Medium blog)
- Updated image paths from /docs/assets/020/ to /img/
- Added template.png, template_logic.png, template-playground.png,
  concerto-logo.svg, typescript-logo.svg to website/static/img/
- Updated grammar.png and studio.png
- Replaced blockchain reference in homepage copy
- Updated GitHub star button to point to template-archive repo

Signed-off-by: Matt Roberts <code@rbrts.uk>

---------

Signed-off-by: ChinmayaBiswal7 <chinmayabiswal44@gmail.com>
Signed-off-by: ChinmayaBiswal7 <chinmayabiswal777@gmail.com>
Signed-off-by: nonononoonononon <yuangli971@gmail.com>
Signed-off-by: Matt Roberts <7544022+mttrbrts@users.noreply.github.com>
Signed-off-by: Matt Roberts <code@rbrts.uk>
Co-authored-by: Chinmaya Biswal <chinmayabiswal777@gmail.com>
Co-authored-by: Yuang Li <118186497+yuanglili@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@mttrbrts mttrbrts mttrbrts approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@ChinmayaBiswal7 @mttrbrts