Skip to content

Conversation

matux
Copy link
Contributor

@matux matux commented Jul 19, 2025

Description of the change

Note

PR description generated by Claude Code

README.md

  • Added Installation section with npm, yarn, and CDN options

  • Added Quick Start section with code examples for:

    • Browser usage with ES modules
    • Node.js usage with CommonJS
    • Script tag usage for CDN users
  • Added link to examples directory for framework-specific integrations

  • I've also made sure all links are working correctly, except for some that seem to link to the same place (although correctly), all seems okay.

  • Replaced non-functional LGTM badges (service discontinued by GitHub) with:

    • npm version badge
    • npm downloads badge

Before

Screenshot 2025-07-21 at 3 27 10 PM

After

Screenshot 2025-07-21 at 3 26 02 PM

CONTRIBUTING.md

Note

Generated by Claude Code.

  • Getting started guide for new contributors
  • Development workflow instructions
  • Code style guidelines
  • Pull request submission process
  • Issue reporting guidelines

examples/README.md

  • Added note about module field in package.json for ES module support
  • Clarified VERSION placeholder usage in CDN URLs

Type of change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Maintenance
  • New release

@matux matux requested a review from Copilot July 19, 2025 14:10
@matux matux self-assigned this Jul 19, 2025
Copilot

This comment was marked as outdated.

Comment on lines -12 to +13
[![Code Quality: Javascript](https://img.shields.io/lgtm/grade/javascript/g/rollbar/rollbar.js.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/rollbar/rollbar.js/context:javascript)
[![Total Alerts](https://img.shields.io/lgtm/alerts/g/rollbar/rollbar.js.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/rollbar/rollbar.js/alerts)
[![npm version](https://img.shields.io/npm/v/rollbar.svg)](https://www.npmjs.com/package/rollbar)
[![npm downloads](https://img.shields.io/npm/dm/rollbar.svg)](https://www.npmjs.com/package/rollbar)
Copy link
Contributor Author

Choose a reason for hiding this comment

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

lgtm was deprecated by github in favor of their native "code scanning" thing which I haven't investigated, decided however to remove these and do (what seems to be) the more classic npm version+downloads.

We have 1.5M dl a month which seemed like a nice number to show off.

README.md Outdated
## Usage and Reference

For complete usage instructions and configuration reference, see our [Javascript SDK docs](https://docs.rollbar.com/docs/javascript).

### Examples

See the [examples directory](./examples/) for detailed integration examples with various frameworks and build tools including React, Angular, Vue.js, Next.js, and more.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This should link straight to the dir, which now contains a README.md itself.

@@ -45,10 +106,11 @@ For bug reports, please [open an issue on GitHub](https://github.com/rollbar/rol

To set up a development environment, you'll need Node.js and npm.

2. `npm install -D`
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'm not sure why the -D...?

README.md Outdated
Comment on lines 51 to 119
To run the tests, run `make test`.
To run the tests: `npm test`
Copy link
Contributor Author

@matux matux Jul 19, 2025

Choose a reason for hiding this comment

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

Don't know why do we even have a Makefile, do js devs not know how to use npm? 😂

I was tempted to remove the Makefile, but I'm not sure if its being used by the CI or something else.

@matux matux changed the title Add installation guide, improve README, fixed broken badged and create CONTRIBUTING.md Add installation guide, improve README, fixed broken badges and create CONTRIBUTING.md Jul 19, 2025
@matux matux force-pushed the matux/update-readme branch from 06aa5b0 to 626c916 Compare July 21, 2025 18:25
@matux matux requested review from waltjones and brianr July 21, 2025 19:44
@matux matux requested a review from brianr July 21, 2025 19:56
@matux matux requested a review from Copilot July 21, 2025 20:10
Copy link
Contributor

@Copilot Copilot AI left a comment

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 project's documentation and contributor experience by adding installation instructions, fixing broken badges, and establishing contribution guidelines. The changes focus on making the project more accessible to new users and contributors.

  • Added comprehensive installation and quick start sections with code examples for multiple environments
  • Replaced non-functional LGTM badges with working npm badges
  • Created a detailed contributing guide with development workflow instructions

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
README.md Added installation section, quick start examples, replaced broken badges, and streamlined content
examples/README.md Improved table formatting, updated code examples, and enhanced documentation clarity
CONTRIBUTING.md New comprehensive guide for contributors with setup, workflow, and submission guidelines

@matux matux enabled auto-merge (squash) July 21, 2025 20:17
@matux matux merged commit 360a714 into master Jul 21, 2025
4 checks passed
@matux matux deleted the matux/update-readme branch July 21, 2025 20:18
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