Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -53,9 +53,13 @@ const config = {

presets: [
[
"classic",
"docusaurus-plugin-glossary/preset",
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Replacing classic preset may break site functionality

The preset was changed from "classic" to "docusaurus-plugin-glossary/preset", but the glossary plugin's package metadata shows it doesn't depend on or include @docusaurus/preset-classic. The configuration still passes classic preset options (docs, blog, theme, sitemap) which may be silently ignored by the glossary preset. This could cause the documentation, blog, theming, and sitemap functionality to stop working. The retained @type {import('@docusaurus/preset-classic').Options} comment further suggests this replacement may be unintentional.

Fix in Cursor Fix in Web

/** @type {import('@docusaurus/preset-classic').Options} */
({
glossary: {
glossaryPath: "glossary/glossary.json",
routePath: "/glossary",
},
docs: {
routeBasePath: "/",
sidebarPath: "./sidebars.js",
Expand Down
57 changes: 57 additions & 0 deletions glossary/glossary.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
{
"description": "Codat terminology and key concepts",
"terms": [
{
"term": "API",
"abbreviation": "Application Programming Interface",
"definition": "A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms.",
"relatedTerms": ["REST", "Webhook"]
},
{
"term": "Connection",
"definition": "A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform.",
"relatedTerms": ["Company", "Data source"]
},
{
"term": "Company",
"definition": "In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources.",
"relatedTerms": ["Connection"]
},
{
"term": "Data source",
"definition": "An external platform (such as QuickBooks, Xero, or a bank) that Codat integrates with to pull or push financial data.",
"relatedTerms": ["Connection", "Integration"]
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Related term references non-existent glossary entry

The "Data source" term's relatedTerms array includes "Integration", but no term with that name is defined in the glossary. This orphaned reference could result in broken links or rendering errors when the glossary plugin attempts to display related terms, depending on how the plugin handles missing references.

Fix in Cursor Fix in Web

},
{
"term": "Webhook",
"definition": "An automated notification sent from Codat to your application when specific events occur, such as when data syncs complete or connections change status.",
"relatedTerms": ["API"]
},
{
"term": "Sync",
"definition": "The process of fetching the latest data from a connected data source. Syncs can be triggered manually or run automatically on a schedule.",
"relatedTerms": ["Connection", "Data source"]
},
{
"term": "SMB",
"abbreviation": "Small and Medium-sized Business",
"definition": "The primary customer segment that Codat helps businesses serve, typically companies with annual revenues under $500 million."
},
{
"term": "Bank Feeds",
"definition": "A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software.",
"relatedTerms": ["Sync"]
},
{
"term": "Link",
"definition": "The authorization flow that allows end users to connect their accounting, banking, or commerce platforms to your application via Codat.",
"relatedTerms": ["Connection", "Company"]
},
{
"term": "REST",
"abbreviation": "Representational State Transfer",
"definition": "An architectural style for designing networked applications. Codat's APIs follow REST principles, using standard HTTP methods.",
"relatedTerms": ["API"]
}
]
}
18 changes: 18 additions & 0 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@
"@stoplight/elements": "^8.4.6",
"buffer": "^6.0.3",
"clsx": "^2.1.1",
"docusaurus-plugin-glossary": "^3.0.0",
"docusaurus-plugin-cookie-consent": "^4.1.0",
"docusaurus-plugin-image-zoom": "^2.0.0",
"docusaurus-plugin-module-alias": "^0.0.2",
Expand Down
Loading