Add cookbooks section with fixed MDX, corrected API usage#39
Conversation
- Add .github/workflows/ci.yml with validate (mintlify validate) and dco-check jobs - Add license field (Apache-2.0) to package.json - CI uses pnpm with frozen lockfile for reproducible builds Signed-off-by: Vorflux AI <noreply@vorflux.com> Co-authored-by: Vorflux AI <noreply@vorflux.com> Signed-off-by: Nishkarsh <ns513@student.london.ac.uk>
Signed-off-by: Nishkarsh <ns513@student.london.ac.uk>
…-cases - Add 8 cookbook MDX files from cookbook-uploading branch to navigation - Fix MDX parsing errors: escape bare `<` outside code fences, fix YAML frontmatter quoting, rename file with parentheses in name - Correct API usage across 4 use-case cookbooks (glean-clone, ai-chief-of-staff, ai-linkedin-recruiter, ai-travel-planner): replace fictional endpoints/methods with real HydraDB API calls - Migrate use-case pages into cookbooks tab, remove Use Cases nav group - Add cookbooks introduction landing page with card grid - Clean up titles (remove "Build a/an" prefix) and replace em dashes - Wire all cookbooks into docs.json navigation under new Cookbooks tab Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Signed-off-by: Nishkarsh <ns513@student.london.ac.uk>
01b96ef to
4bf7d26
Compare
Greptile SummaryThis PR adds a new Cookbooks navigation section with 12 MDX guides, migrates 4 existing use-case pages into it, fixes MDX parsing errors, and corrects API usage across the moved files to match real HydraDB endpoints. The bulk of the content is well-structured and the API patterns (
Confidence Score: 4/5Safe to merge after fixing the broken email link in hydradb-cookbook-06.mdx; the duplicate nav entry is a usability issue worth resolving before or shortly after merge. One P1 content defect (broken contact link in a published cookbook) should be fixed before the page goes live. The duplicate "AI Chief of Staff" nav entry is confusing but not blocking. All other findings are P2 style/consistency suggestions. cookbooks/hydradb-cookbook-06.mdx (broken email link, P1) and cookbooks/index.mdx / docs.json (duplicate AI Chief of Staff entries, P2). Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A["docs.json\nCookbooks tab added\nUse Cases tab removed"] --> B["cookbooks/index.mdx\n12-card landing grid"]
B --> C1["Moved from use-cases\nglean-clone\nai-chief-of-staff\nai-linkedin-recruiter\nai-travel-planner"]
B --> C2["New cookbooks\ncookbook-01 · cookbook-04\ncookbook-10 · customer-support\ncompetitive-intel · perplexity\nai-onboarding · hydradb-cookbook-06"]
C1 -->|"API corrections applied"| D["Real HydraDB endpoints\nPOST /ingestion/upload_knowledge\nPOST /recall/full_recall\nPOST /recall/recall_preferences\nPOST /memories/add_memory"]
C2 --> D
B -->|"duplicate title"| E["ai-chief-of-staff.mdx\nhydradb-cookbook-06.mdx\nboth titled AI Chief of Staff"]
C2 -->|"broken link"| F["hydradb-cookbook-06.mdx\nCloudflare email artifact\nline 32"]
Reviews (1): Last reviewed commit: "Add cookbooks section: fix MDX errors, c..." | Re-trigger Greptile |
- Replace CloudFlare email-protected link with plain mailto in hydradb-cookbook-06.mdx - Rename "AI Chief of Staff" to "AI Chief of Staff - Function Routing" to distinguish from the n8n variant Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Signed-off-by: Nishkarsh <ns513@student.london.ac.uk>
…kbooks-local Signed-off-by: Nishkarsh <ns513@student.london.ac.uk> # Conflicts: # cookbooks/ai-chief-of-staff.mdx # package.json
Description
Merges the cookbook-uploading branch content into the docs site, fixes all MDX parsing errors, corrects API usage across 4 use-case cookbooks to match real HydraDB endpoints, and consolidates everything under a new Cookbooks navigation tab with an introduction landing page.
<outside code fences, broken YAML frontmatter, parentheses in filenames)Related Issue
Closes #
Type of Change
Checklist
git commit -s) per the DCOmintlify devrenders my changes correctly