Skip to content

Add installation guide, improve README, fixed broken badges and create CONTRIBUTING.md - #1248

Merged
matux merged 11 commits into
masterfrom
matux/update-readme
Jul 21, 2025
Merged

Add installation guide, improve README, fixed broken badges and create CONTRIBUTING.md#1248
matux merged 11 commits into
masterfrom
matux/update-readme

Conversation

@matux

@matux matux commented Jul 19, 2025

Copy link
Copy Markdown
Contributor

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

This comment was marked as outdated.

Comment thread README.md
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
Copy Markdown
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.

Comment thread README.md Outdated
Comment thread README.md Outdated

### 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
Copy Markdown
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.

Comment thread README.md

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

2. `npm install -D`

Copy link
Copy Markdown
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...?

Comment thread README.md Outdated
Comment on lines +51 to +119
To run the tests, run `make test`.
To run the tests: `npm test`

@matux matux Jul 19, 2025

Copy link
Copy Markdown
Contributor Author

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
Comment thread examples/README.md Outdated
@matux
matux requested review from brianr and waltjones July 21, 2025 19:44
Comment thread CONTRIBUTING.md
Comment thread CONTRIBUTING.md
@matux
matux requested a review from brianr July 21, 2025 19:56
Comment thread README.md Outdated
Comment thread examples/README.md Outdated
Comment thread examples/README.md Outdated
@matux
matux requested a review from Copilot July 21, 2025 20:10

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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

Comment thread CONTRIBUTING.md
Comment thread examples/README.md Outdated
@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.

4 participants