Skip to content

[Feature] "inline" PR creation with ehanced rules #55

@pawel-twardziak

Description

@pawel-twardziak

Boundaries: for logged in users

  • User can edit rules directly in a browser
  • then user clicks "Raise a PR"
  • a PR for the modified rules is automatically created

PROS: this will significantly encourage people to contribute to the rules :)
CONS: --- no cons 😆 ---

CAPTION: I am willing to dirty my hands working on this exciting feature :)

Activity

psmyrdek

psmyrdek commented on May 15, 2025

@psmyrdek
Collaborator

Great idea @pawel-twardziak, but adding my two cents:

  1. The ratio between added complexity and added value is unclear to me - we know that the codebase will grow, but we have no idea how many people would be interested in that feature. My bet - not that many, as on the internet more people tend to consume content that contribute to something they use. And there's still Github that you can use to edit rules.

  2. Actually, full inline edit and customization is something that we may want to introduce in the future. So there would be mixed concerns between editing for yourself vs editing for community (via PR). I believe we should prioritize edits for you and your team, instead of edits as Github PR workaround.

BTW - GREAT (!) that we start from the discussion here instead of coding, kudos for that 👏


Solution for easier validation:

Instead of full inline editing, I'd consider third action for sth like "Make it better / Fork it / Raise new PR" (good icon needed), linking to PR with dedicated file:

Image

By going that way, we minimize in-app complexity, delegating rule modification to Github. Once there's increased activity around rules, we may turn it into inline editing and raising PRs.

Happy to consider other ideas @pawel-twardziak @mkczarkowski

psmyrdek

psmyrdek commented on May 15, 2025

@psmyrdek
Collaborator

Potentially - something to mix and merge with #54

pawel-twardziak

pawel-twardziak commented on May 26, 2025

@pawel-twardziak
ContributorAuthor

@psmyrdek nice elaboration on the idea 🚀 thanks! I will reply today more😺

pawel-twardziak

pawel-twardziak commented on May 27, 2025

@pawel-twardziak
ContributorAuthor

"Improve This Rule" Button (Immediate Implementation)

  • Add a single action button with icon (e.g., 🔧 or 📝)
  • Link directly to GitHub's edit page for the specific rule file
  • Pre-populate PR template with improvement guidelines
  • Track clicks to measure engagement

Smart PR Helper (Future Enhancement)

When clicked, open a modal showing:

  • Current rule content
  • Quick improvement tips
  • Direct link to create PR with pre-filled description

Include contributor recognition on successful PRs

Implementation Benefits:

  • Minimal complexity: Just adds strategic links
  • Leverages GitHub's existing UI
  • Lowers contribution barrier significantly
  • Maintains clean separation of concerns

Combined Strategy:

  • Show rating data next to "Improve This Rule" button
  • Prioritize improvements for low-rated but frequently viewed rules
  • Add "Contributors" count alongside reactions
  • Create monthly "Rule Improvement Challenge" highlighting rules needing updates

Marketing & Community Benefits

Gamification Elements

  • "Top Contributors" leaderboard
  • "Most Improved Rules" section
  • Monthly highlights in project newsletter

Social Proof

  • Display "1.2k developers use this rule"
  • Show "Improved by 5 contributors"
  • Feature testimonials from rule improvements

Low-Friction Engagement

  • One-click reactions
  • Two-click contributions
  • Instant visibility of impact

Success Metrics

  • Reaction engagement rate (target: 15% of visitors)
  • PR creation rate (target: 2-3% of engaged users)
  • Rule quality improvement (measured by reaction ratios)
  • Contributor retention (repeat contributions)

This approach maintains simplicity while creating a virtuous cycle: better rules attract more users, more users provide feedback, feedback drives improvements, and improvements attract contributors. The key is starting small with reactions and strategic PR links, then expanding based on actual usage patterns.

pawel-twardziak

pawel-twardziak commented on May 27, 2025

@pawel-twardziak
ContributorAuthor

The heck, my imagination is endless 😆

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      [Feature] "inline" PR creation with ehanced rules · Issue #55 · przeprogramowani/ai-rules-builder