Skip to content

Improve LeadForge README presentation#101

Merged
shaypal5 merged 1 commit into
mainfrom
codex/improve-leadforge-readme-presentation
May 30, 2026
Merged

Improve LeadForge README presentation#101
shaypal5 merged 1 commit into
mainfrom
codex/improve-leadforge-readme-presentation

Conversation

@shaypal5

Copy link
Copy Markdown
Contributor

Summary

Improve the GitHub landing-page presentation for LeadForge so a first-time visitor can immediately understand the project, find the docs, and see what generated output looks like.

Changes

  • Add CI, docs, license, and Python-version badges at the top of the README.
  • Add prominent documentation and published-dataset links near the opening description.
  • Add a concise "What Makes LeadForge Different" section that explains the world-simulation, relational CRM, and teaching-oriented realism story.
  • Add a compact generated lead-scoring data preview table from the intermediate bundle.
  • Replace the local-docs list with public docs-site links for the main onboarding paths.
  • Update the bottom Credits block to the current required creator-credit format.

GitHub metadata

Updated directly on the repository card with gh repo edit:

  • Description: Opinionated framework for generating synthetic CRM and GTM datasets from simulated commercial worlds.
  • Homepage: https://leadforge-dev.github.io/leadforge/
  • Topics: synthetic-data, crm, gtm, lead-scoring, python, teaching

Validation

  • git diff --check -- README.md
  • README smoke check: exactly two creator-credit occurrences, docs URL present, generated-data preview present
  • Pre-commit hooks run by commit: trailing whitespace, end-of-file, merge-conflict checks passed

Notes

A pre-existing local edit to release/kaggle/dataset-metadata.json was intentionally left unstaged and is not part of this PR.

Copilot AI review requested due to automatic review settings May 30, 2026 21:34
@shaypal5 shaypal5 added documentation Improvements or additions to documentation type: docs Documentation or narrative changes status: needs review Ready for review labels May 30, 2026
@github-actions

Copy link
Copy Markdown

pr-agent-context report:

No unresolved review comments, failing checks, or actionable patch coverage gaps were found on PR #101 in repository https://github.com/leadforge-dev/leadforge. Treat this PR as all clear unless new signals appear.

Run metadata:

Tool ref: v4
Tool version: 4.0.21
Trigger: pull request opened
Workflow run: 26695510900 attempt 1
Comment timestamp: 2026-05-30T21:34:49.519256+00:00
PR head commit: a106e9811a31b52cf3d062c963d943c3849b6cfb

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This PR improves the repository’s GitHub landing-page README so first-time visitors can quickly understand LeadForge, find the hosted docs, and see a concrete example of generated output.

Changes:

  • Add top-of-page badges (CI, docs, license, Python version) and prominent docs/dataset links near the introduction.
  • Add a “What Makes LeadForge Different” section plus a compact generated-data preview table.
  • Replace local documentation links with public docs-site URLs and update the Credits block formatting.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
**Opinionated framework for generating synthetic CRM and GTM datasets from simulated commercial worlds.**

Created by [Shay Palachy Affek](https://www.shaypalachy.com/).
Created by [Shay Palachy Affek](http://www.shaypalachy.com/).
Comment thread README.md
## Credits

Created by [Shay Palachy Affek](https://www.shaypalachy.com/) · [HuggingFace](https://huggingface.co/shaypal5) · [Kaggle](https://www.kaggle.com/derelictpanda) · [GitHub](https://github.com/shaypalachy)
Created by [Shay Palachy Affek ](http://www.shaypalachy.com/) [[GitHub](https://github.com/shaypal5)]
Comment thread README.md
| train | logistics | UK | 500-999 | inbound_marketing | 5 | 2 | False | 58,372 | False |
| train | logistics | US | 200-499 | partner_referral | 9 | 3 | True | 15,462 | False |
| train | healthcare_non_clinical | US | 200-499 | inbound_marketing | 5 | 1 | True | 30,490 | False |
| train | manufacturing | US | 1000-1999 | sdr_outbound | missing | 1 | True | 42,999 | False |
@shaypal5 shaypal5 merged commit 05819ed into main May 30, 2026
11 checks passed
@shaypal5 shaypal5 deleted the codex/improve-leadforge-readme-presentation branch May 30, 2026 21:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation status: needs review Ready for review type: docs Documentation or narrative changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants