Skip to content

Commit

Permalink
Update doc repo collaterals (#1584)
Browse files Browse the repository at this point in the history
* Update repo collaterals

* Fix links in Contributing.md

* Update CONTRIBUTING.md

* Update SECURITY.md

* Update CONTRIBUTING.md

* wording fix
  • Loading branch information
aepanchi authored Dec 12, 2023
1 parent 5b308be commit 21d58a3
Show file tree
Hide file tree
Showing 3 changed files with 93 additions and 18 deletions.
40 changes: 22 additions & 18 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,39 +17,43 @@

# How to Contribute

We welcome community contributions to Intel(R) Extension for Scikit-learn. You can:
As an open source project, we welcome community contributions to Intel(R) Extension for Scikit-learn.
This document explains how to participate in project conversations, log bugs and enhancement requests, and submit code patches.

- Submit your changes directly with a [pull request](https://github.com/intel/scikit-learn-intelex/pulls).
- Log a bug or make a feature request with an [issue](https://github.com/intel/scikit-learn-intelex/issues).
## Licensing

Refer to our guidelines on [pull requests](#pull-requests) and [issues](#issues) before you proceed.
Intel(R) Extension for Scikit-learn uses the [Apache 2.0 License](https://github.com/intel/scikit-learn-intelex/blob/master/LICENSE).
By contributing to the project, you agree to the license and copyright terms and release your own contributions under these terms.

## Issues
## Pull Requests

Use [GitHub issues](https://github.com/intel/scikit-learn-intelex/issues) to:
- report an issue
- make a feature request
No anonymous contributions are accepted. The name in the commit message Signed-off-by line and your email must match the change authorship information.

**Note**: To report a vulnerability, refer to [Intel vulnerability reporting policy](https://www.intel.com/content/www/us/en/security-center/default.html).
Make sure your ``.gitconfig`` is set up correctly so you can use `git commit -s` for signing your patches:

## Pull Requests
`git config --global user.name "Kate Developer"`

To contribute your changes directly to the repository, do the following:
- Make sure you can build the product and run all the examples with your patch.
- For a larger feature, provide a relevant example.
- Document your code.
- [Submit](https://github.com/intel/scikit-learn-intelex/pulls) a pull request into the `master` branch. Provide a brief description of the changes you are contributing.
`git config --global user.email kate.developer@company.com`

### Before Contributing Changes

Public CI is enabled for the repository. Your PR should pass all of our checks. We will review your contribution and, if any additional fixes or modifications are necessary, we may give some feedback to guide you. When accepted, your pull request will be merged into our GitHub repository.
* Make sure you can build the product and run all the tests with your patch.
* For a larger feature, provide a relevant test.
* Document your code. Our project uses reStructuredText for documentation.
* For new file(s), specify the appropriate copyright year in the first line.
* Submit a pull request into the master branch.

Continuous Integration (CI) testing is enabled for the repository. Your pull request must pass all checks before it can be merged. We will review your contribution and may provide feedback to guide you if any additional fixes or modifications are necessary. When reviewed and accepted, your pull request will be merged into our GitHub repository.

## Code Style

We use [black](https://black.readthedocs.io/en/stable/) and [isort](https://pycqa.github.io/isort/) formatters for Python* code. The line length is 90 characters; use default options otherwise. You can find the linter configuration in our [.pyproject.toml](https://github.com/intel/scikit-learn-intelex/blob/master/pyproject.toml).
We use [black](https://black.readthedocs.io/en/stable/) and [isort](https://pycqa.github.io/isort/) formatters for Python* code. The line length is 90 characters; use default options otherwise. You can find the linter configuration in [.pyproject.toml](https://github.com/intel/scikit-learn-intelex/blob/master/pyproject.toml).

A GitHub* Action verifies if your changes comply with the output of the auto-formatting tools.

Optionally, you can install pre-commit hooks that do the formatting for you. For this, run from the top level of the repository:

```bash
pip install pre-commit
pre-commit install
```
```
29 changes: 29 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
<!--
******************************************************************************
* Copyright 2023 Intel Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*******************************************************************************/-->

# Security Policy

## Report a Vulnerability

Please report security issues or vulnerabilities to the [Intel Security Center].

For more information on how Intel works to resolve security issues, see
[Vulnerability Handling Guidelines].

[Intel Security Center]:https://www.intel.com/security

[Vulnerability Handling Guidelines]:https://www.intel.com/content/www/us/en/security-center/vulnerability-handling-guidelines.html
42 changes: 42 additions & 0 deletions SUPPORT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
<!--
******************************************************************************
* Copyright 2023 Intel Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*******************************************************************************/-->

# Intel(R) Extension for Scikit-learn Support

We are committed to providing support and assistance to help you make the most out of Intel(R) Extension for Scikit-learn.
Use the following methods if you face any challenges.


## Issues

If you have a problem, check out the [GitHub Issues](https://github.com/intel/scikit-learn-intelex/issues) to see if the issue you want to address is already reported.
You may find users that have encountered the same bug or have similar ideas for changes or updates.

You can use issues to report a problem, make a feature request, or add comments on an existing issue.

## Discussions

Visit the [GitHub Discussions](https://github.com/intel/scikit-learn-intelex/discussions) to engage with the community, ask questions, or help others.

## Forum

Ask questions about Intel(R) Extension for Scikit-learn on our [Forum](https://community.intel.com/t5/Intel-Distribution-for-Python/bd-p/distribution-python).
Make sure to provide all relevant details, so we could help you as soon as possible.

## Email

Reach out to us privately via [email](mailto:onedal.maintainers@intel.com).

0 comments on commit 21d58a3

Please sign in to comment.