Commit Graph

7 Commits

Author SHA1 Message Date
Nicholas Tindle
0f406f4ace fix(docs): add file headers and consistent heading levels
- Add h1 file title with manual description section to all doc files
- Make all blocks use h2 headings (previously first block was h1)
- Make all sections use h3 headings consistently
- Add title fixes for GitHub, LLM, API, HubSpot, LinkedIn, etc.
- Add --check warning for unfilled manual sections (116 files)
- Fill in descriptions for top-level category files

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 18:26:25 -06:00
Nicholas Tindle
8f263c4a96 fix(docs): show all enum values in block documentation
Remove truncation of enum values to 3 items, ensuring all options are
included in generated docs. This improves embedding quality by capturing
complete information about available choices.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 18:02:27 -06:00
Nicholas Tindle
703a42c130 fix(backend): add blank lines around markdown tables (MD058)
- Add blank line between section heading and table header for Inputs,
  Outputs, and overview tables
- Add fallback for empty anyOf options in type_to_readable

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 16:52:53 -06:00
Nicholas Tindle
470a15cb06 fix(backend): fix Dict[str, True] type annotation and remove --migrate flag
- Fix type_to_readable to return Dict[str, Any] when additionalProperties
  is true (was incorrectly returning Dict[str, True])
- Remove --migrate flag and extract_legacy_content/strip_markers functions
  (migration already completed)
- Fix stray quote in Medium block author_id description

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 16:47:28 -06:00
Nicholas Tindle
c3654c9431 fix(backend): fix block docs generator name parsing and content preservation
- Use removesuffix("Block") instead of replace("Block", "") to only
  remove the suffix, not all occurrences (fixes "TwitterGetBlockedUsers"
  becoming "TwitterGetedUsers")
- Fix regex patterns to capture until --- separator instead of next
  heading, ensuring manual content between MANUAL markers is preserved

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 16:37:09 -06:00
Nicholas Tindle
2487a85a65 docs(integrations): regenerate block docs with fixes
Regenerated all block documentation to apply:
- Newline normalization in table cells
- Pipe character escaping in type strings
- Computed section heading levels (h2 for h1 blocks, h3 for h2 blocks)
- Fixed "appearch" typo in Apollo organization blocks

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 16:21:11 -06:00
Nicholas Tindle
462082591c docs(blocks): Move block documentation to docs/integrations for separate GitBook space
- Move all block docs from docs/platform/blocks/ to docs/integrations/
- Rename blocks.md to README.md for landing page at /integrations
- Update generate_block_docs.py output path to docs/integrations
- Update workflow files (docs-block-sync, docs-claude-review, docs-enhance)
  to reference new docs/integrations/ path
- Change block doc links to absolute URLs for cross-space compatibility

This separates block/integration documentation into its own GitBook space
to avoid path conflicts with the platform space.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 15:09:48 -06:00