Skip to content

Conversation

@harumiWeb
Copy link
Owner

@harumiWeb harumiWeb commented Jan 5, 2026

Summary by CodeRabbit

  • Documentation
    • Updated README with more realistic examples of ExStruct JSON and LLM reconstruction outputs
    • Replaced placeholder content with actual Federal Financial Report sample data
    • Enhanced examples to showcase complete document structure including shapes, print areas, and merged cells metadata

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 5, 2026

📝 Walkthrough

Walkthrough

README.md documentation updated with more realistic and complete examples of Excel form JSON structure and LLM reconstruction output, replacing placeholder content with actual Federal Financial Report (FFR) form data and refining metadata.

Changes

Cohort / File(s) Summary
Documentation & Examples
README.md
Fixed image path reference; replaced placeholder JSON content with concrete FFR form examples including proper sheet names, cell values, shapes metadata, print areas, and merged cell definitions; expanded LLM reconstruction examples with full form sections (Agency through Agency Use Only) replacing ambiguous placeholders

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • v0.2.80 #18 — Modifies README sample JSON shape metadata by adding/updating shape entries and connector/ID fields alongside similar example updates.

Poem

🐰 A rabbit hops through docs so fine,
Where placeholders once did pine,
Now FFR forms shine so bright,
With real examples, clean and right!
No more question marks to guess,
Just lovely structure, nothing less!

Pre-merge checks

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'document bug fix' is vague and generic. It fails to describe the specific changes made (README updates for Excel/FFR sample corrections and restructuring). Use a more specific title that describes the actual changes, such as 'Update README with corrected Excel/FFR sample and LLM reconstruction examples' or similar.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov-commenter
Copy link

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a08f4ba and a1c6596.

📒 Files selected for processing (1)
  • README.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Codacy Static Code Analysis
🔇 Additional comments (2)
README.md (2)

351-395: Updated JSON example with realistic FFR form data — LGTM.

The JSON example now demonstrates ExStruct output with actual Federal Financial Report form data rather than placeholders. The structure correctly includes:

  • Realistic row content with form headings and field labels
  • Shapes array showing example shape extraction ("Not Required by EPA")
  • Print areas with proper coordinate ranges
  • Merged cells with actual values (e.g., "Federal Share Calculation")

The example is appropriately truncated for readability and is instructive for users understanding ExStruct's output format.


401-550: LLM reconstruction example is comprehensive and well-structured.

The expanded example effectively demonstrates how ExStruct JSON can be reconstructed by an LLM into readable Markdown. The inclusion of all 14 form sections, proper formatting, signature blocks, legal statements, and metadata is excellent for documentation purposes.

Note on form currency: The example references OMB number 0348-0061 with an expiration date of 02/28/2015. Please confirm whether:

  • This is intentionally a historical form example, or
  • The form reference should be updated to the current version (if a newer SF 425 / FFR form exists)

This does not block the documentation update but should be clarified in context if this is meant to be a current-day example.

### Excel Sheet

![General Application Form Excel](/docs/assets/demo_form.en.png)
![General Application Form Excel](/docs/assets/demo_form_en.png)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify image file existence and check for outdated form references

# Check if the corrected image file exists
if [ -f "docs/assets/demo_form_en.png" ]; then
  echo "✓ Image file exists: docs/assets/demo_form_en.png"
else
  echo "✗ Image file NOT found: docs/assets/demo_form_en.png"
  echo "Available images in docs/assets:"
  find docs/assets -type f \( -name "*.png" -o -name "*.jpg" -o -name "*.webp" \) 2>/dev/null || echo "No images found"
fi

# Check for old OMB references in README
echo ""
echo "OMB references found in README:"
rg -n "OMB" README.md || echo "No OMB references found"

# Check for outdated expiration dates
echo ""
echo "Checking for dates in README:"
rg -n "Expiration|02/28/2015" README.md | head -20 || echo "No matching patterns found"

Repository: harumiWeb/exstruct

Length of output: 508


🌐 Web query:

OMB 0348-0061 Standard Form 425 current status 2025

💡 Result:

Short answer: OMB control number 0348-0061 is a historical/older approval for the SF‑425; the current active OMB control for the Federal Financial Report (SF‑425) in 2025 is OMB 4040‑0014 (expiration 02/28/2025). Agencies/websites sometimes still show 0348‑0061 on older copies of the form. [1][2][3]

Sources:

  • OMB 0348‑0061 page (historical SF‑425 materials). [1]
  • ACF / Grants pages showing SF‑425 listed under OMB 4040‑0014, expiration 02/28/2025. [2]
  • ICR/OMB.report listing SF‑425 (OMB 4040‑0014) with expiration 02/28/2025. [3]

Update OMB form reference to current active form.

The image file exists at the corrected path, which is correct. However, the OMB form reference is outdated and should be updated:

  • Current (incorrect): OMB Approval Number 0348-0061 with Expiration Date 02/28/2015
  • Should be: OMB Approval Number 4040-0014 with Expiration Date 02/28/2025

The form number 0348-0061 is a historical reference; the current active OMB control number for the Standard Form 425 (Federal Financial Report) is 4040-0014. Since the documentation aims to show realistic examples, update lines 527-528 to use the current form reference.

🤖 Prompt for AI Agents
README.md lines 527-528: the OMB form reference is outdated—replace "OMB
Approval Number 0348-0061 with Expiration Date 02/28/2015" with the current
control number and expiry "OMB Approval Number 4040-0014 with Expiration Date
02/28/2025"; update the text exactly where the form reference appears (lines
527-528) so the documentation shows the current SF-425 OMB control number and
expiration date.

@harumiWeb harumiWeb merged commit c6f6e92 into main Jan 5, 2026
9 checks passed
@harumiWeb harumiWeb deleted the doc_fix branch January 5, 2026 04:00
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.

3 participants