Skip to content

docs: rewrite README and trim docs/#194

Merged
fuzzzerd merged 1 commit intomasterfrom
fuzzz/docs-update
Apr 24, 2026
Merged

docs: rewrite README and trim docs/#194
fuzzzerd merged 1 commit intomasterfrom
fuzzz/docs-update

Conversation

@fuzzzerd
Copy link
Copy Markdown
Owner

Summary

Rewrite the README to lead with what SharpFM does — decode FileMaker's closed clipboard format into plain XML plus structured editors, let you edit/save/share/diff, and re-encode on the way back — and why that middle step is useful (version control, Remote Desktop/Citrix boundaries, real editors, inspection). Step-by-step menu walkthroughs and the plugin section collapsed into a tighter How It Works plus a plain feature list.

Trim docs/:

  • docs/plans/ removed — the POCO migration it tracked is complete.
  • docs/step-definitions.md removed — working checklist for the same migration; all Priority 1 steps have typed POCOs and the Priority 3 long tail is explicitly on-demand.
  • docs/plugins/ removed — described four plugin types but only Panel and Transform exist in code. Replaced with a minimal docs/plugins.md that points at the contract projects and sample.
  • docs/advanced-filemaker-scripting-syntax.md — noted that Inputs: blocks (Show Custom Dialog) are already implemented alongside Buttons:, and dropped the single-entry change log.

No code changes; test suite still passes (1,177 tests, 0 failures).

Rewrite README to lead with what SharpFM does (extract FileMaker objects as editable XML and round-trip them back) and why it's useful (version control, cross-RDP/Citrix, real editors, inspection). Drop the step-by-step menu/plugin walkthroughs in favor of a tighter How It Works section.

Remove obsolete docs:
- docs/plans/ — POCO migration is complete.
- docs/step-definitions.md — the POCO migration tracker; all Priority 1 steps have typed implementations and the Priority 3 long tail is explicitly on-demand.
- docs/plugins/ — described four plugin types (Panel, Event, Persistence, Transform) but only Panel and Transform exist; replaced with a minimal docs/plugins.md pointer to the contracts and sample project.

Update docs/advanced-filemaker-scripting-syntax.md to note that Show Custom Dialog's Inputs: block is already implemented, and drop the single-entry change log.
@fuzzzerd fuzzzerd enabled auto-merge (rebase) April 24, 2026 23:36
@github-actions
Copy link
Copy Markdown

Test Results

✔️ Tests 1177 / 1177 - passed in 10.1s
✔️ Coverage 78.46% - passed with 70% threshold
📏 13413 / 15637 lines covered 🌿 4652 / 7387 branches covered
🔍 click here for more details

✏️ updated for commit 0a41296

@fuzzzerd fuzzzerd merged commit 6786308 into master Apr 24, 2026
6 checks passed
@fuzzzerd fuzzzerd deleted the fuzzz/docs-update branch April 24, 2026 23:37
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.

1 participant