Skip to content

chore: contributing-information #543

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from

Conversation

ryanbas21
Copy link
Contributor

JIRA Ticket

https://pingidentity.atlassian.net/browse/SDKS-3970

Description

Add and align the contributing documentation with other platforms

Copy link

changeset-bot bot commented May 21, 2025

⚠️ No Changeset found

Latest commit: fa4fe24

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link

nx-cloud bot commented May 21, 2025

View your CI Pipeline Execution ↗ for commit fa4fe24.

Command Status Duration Result
nx affected -t build lint test docs e2e-ci --ve... ✅ Succeeded <1s View ↗
nx-cloud record -- nx format:check --verbose ✅ Succeeded 5s View ↗

☁️ Nx Cloud last updated this comment at 2025-05-22 13:11:56 UTC

`pnpm nx e2e autoscript-suites`
`pnpm nx serve autoscript-apps`
```

### Git Flow

Fork the repo to your own github account. From there, you can add the ForgeRock repository as an upstream.

Choose a reason for hiding this comment

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

I think we can move this content to the section Fork and Clone the Repository above

Choose a reason for hiding this comment

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

I think we still need to address it

@ryanbas21 ryanbas21 force-pushed the contributing-information branch from 0339720 to d8259f9 Compare May 22, 2025 13:06
@ryanbas21 ryanbas21 force-pushed the contributing-information branch from d8259f9 to fa4fe24 Compare May 22, 2025 13:10

## Standards of Practice

We ask that all contributors to this project adhere to our engineering Standard for team culture, practices and code of conduct. We expect everyone to be respectful, inclusive, and collaborative. Any violations will be handled according to the project's guidelines.
Copy link
Contributor

Choose a reason for hiding this comment

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

Should we provide a link to these standards/guidelines?

Copy link

@rodrigoareis rodrigoareis left a comment

Choose a reason for hiding this comment

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

Overall changes look good, left two suggested changes to be reviewed


We ask that all contributors to this project adhere to our engineering Standard for team culture, practices and code of conduct. We expect everyone to be respectful, inclusive, and collaborative. Any violations will be handled according to the project's guidelines.

For more details on our Standards of Practice, please refer to the SDK Standards of Practice documentation.

Choose a reason for hiding this comment

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

Suggested change
For more details on our Standards of Practice, please refer to the SDK Standards of Practice documentation.
For more details on our Standards of Practice, please refer to the [SDK Standards of Practice](https://github.com/ForgeRock/sdk-standards-of-practice) documentation.


For more details on our Standards of Practice, please refer to the SDK Standards of Practice documentation.

### Here is a checklist of items to ensure your Pull Request is reviewed and ready to be merged:

Choose a reason for hiding this comment

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

Suggested change
### Here is a checklist of items to ensure your Pull Request is reviewed and ready to be merged:
## Creating a Pull Request (PR)
This section covers how to create your changes, and submit them for review by Ping Identity engineers
by using a Pull Request. A PR is a formal request to merge your changes from your forked repository into
the main project. The following steps will guide you on creating a well-structured PR that
facilitates efficient review and integration of your contributions.
### Create a New Branch
Always create a new branch to work on your changes. Avoid making changes directly on the `develop` or `master` branch.
```bash
git checkout -b feature/my-new-feature

Make Your Changes

Implement the required changes or new features. Make sure to write clean, well-commented, and readable code. If applicable, include tests and documentation for the new functionality.

Commit Your Changes

Once you’ve made your changes, commit them with a clear and descriptive message. Note that our
repository requires all commits to be signed. For more information on signing commits, please refer to
the GitHub Docs

The commit message should follow this structure:

[TYPE] Short description of the changes

Types:

  • feat: A new feature
  • fix: A bug fix
  • docs: Documentation changes
  • refactor: Code refactoring (no feature change)
  • test: Adding or modifying tests

Example:

git commit -S -m "feat: add login functionality"

Push Your Changes

After committing your changes, push them to your fork:

 git push origin feature/my-new-feature

Create a Pull Request

  1. Go to your fork on GitHub.

  2. Click on the "New Pull Request" button.

  3. Select the base repository and base branch (usually develop), then select the branch you just pushed.

  4. Fill out the PR Template

    Make sure to fill out the PR template provided. The template helps us better understand your change. Typically, a PR will require the following information:

    • Add a title and description for the PR. The description should include:
      • What was changed and why.
      • Any related issues.
      • Any additional context if necessary, for example relevant screenshots or breaking changes.

    Once everything looks good, submit the PR for review.

PR Review and Feedback

Once the PR is submitted, the team will review it. Be prepared to:

  • Address any feedback or requested changes.
  • Keep your branch up to date with the base branch by rebasing or merging.

Here is a checklist of items to ensure your Pull Request is reviewed and ready to be merged:


:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
Welcome! We are excited that you are interested in contributing to the Ping SDK for JavaScript. This document will guide you through the steps required to contribute to the project.

The following is a set of guidelines for contributing to the Forgerock SDK and its packages, which are hosted in the [ForgeRock organization](https://github.com/forgerock) on GitHub.

Choose a reason for hiding this comment

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

Suggested change
The following is a set of guidelines for contributing to the Forgerock SDK and its packages, which are hosted in the [ForgeRock organization](https://github.com/forgerock) on GitHub.
The following is a set of guidelines for contributing to the Ping SDK and its packages, which are hosted in the [ForgeRock organization](https://github.com/forgerock) on GitHub.

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

Successfully merging this pull request may close these issues.

3 participants