Skip to main content

Adding Compatibility Rules

Contribute compatibility data by submitting verified information about how two technologies work together.

Before You Submit

Check if Data Exists

  1. Visit devradar.dev/check
  2. Search for your technology pair
  3. If status is “unknown”, your submission is valuable

Verify Your Information

Only submit what you’ve personally verified: Required information:
  • Technology names
  • Compatibility status
  • Evidence/source links
  • Your testing context

What to Submit

Required Fields

Optional Fields

Status Guidelines

Compatible ✅

Use when technologies work together without issues. Example:

Partial ⚠️

Use when technologies work but with limitations. Example:

Incompatible ❌

Use when technologies have fundamental conflicts. Example:

Submission Methods

  1. Go to github.com/devradar-dev/website/issues
  2. Click “New Issue”
  3. Use “Compatibility Data” template
  4. Fill in all fields
  5. Submit
Template:

Method 2: Discussion Post

For complex submissions or questions:
  1. Go to github.com/devradar-dev/website/discussions
  2. Start a new discussion
  3. Use “Compatibility Data” category
  4. Post your submission

Method 3: API (Developers)

Submit via API (requires authentication):

Review Process

What We Check

  1. Accuracy - Can we verify the information?
  2. Evidence - Are sources provided?
  3. Clarity - Is the explanation clear?
  4. Completeness - Are all required fields filled?

Timeline

After Submission

You’ll receive updates:
  • Under Review - Being evaluated
  • Approved - Added to database
  • Changes Requested - Needs more info
  • Declined - Cannot accept (with reason)

Best Practices

1. Test Before Submitting

Actually use the technologies together:

2. Document Your Context

Help us understand your setup:
Strong sources strengthen your submission:
  • Official documentation (best)
  • Official GitHub issues (good)
  • Blog posts from maintainers (acceptable)
  • Your own testing (with details)

4. Be Specific

5. Update When Versions Change

If you submitted data for older versions, submit updates when new versions release:

What Happens After Approval

Your submission becomes part of the database:
  1. Compatibility checks - API returns your data
  2. Scans - Projects scanned with this info
  3. Content - May be used in guides/comparisons
  4. Attribution - Your username credited (optional)

Examples

Example 1: Compatible

Example 2: Partial with Workaround

What’s Next


Submit now: Open an Issue