Merge pull request #2 from nv-rliu/branch-24.12-setup-repo

Branch 24.12 setup repo

.flake8

@@ -1,4 +1,4 @@
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2024, NVIDIA CORPORATION.
 
 [flake8]
 filename = *.py, *.pyx, *.pxd, *.pxi

.github/CODEOWNERS

@@ -1,23 +1,28 @@
 # https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners
 # Order matters - match of highest importance goes last (last match wins)
 
-
-# doc code owners
-# 
-
-
-# python code owners
-# example
-# python/nx_cugraph			@rapidsai/nx-cugraph-python-codeowners
-
-
-# CI code owners
-# /ci/			@rapidsai/ci-codeowners
-
-
-# packaging code owners
-# /conda/            @rapidsai/packaging-codeowners
-# /dependencies.yaml @rapidsai/packaging-codeowners
-# /build.sh          @rapidsai/packaging-codeowners
-# pyproject.toml     @rapidsai/packaging-codeowners
-# VERSION            @rapidsai/packaging-codeowners
+#doc code owners
+datasets/          @rapidsai/nxcugraph-doc-codeowners
+notebooks/         @rapidsai/nxcugraph-doc-codeowners
+docs/              @rapidsai/nxcugraph-doc-codeowners
+**/*.txt           @rapidsai/nxcugraph-doc-codeowners
+**/*.md            @rapidsai/nxcugraph-doc-codeowners
+**/*.rst           @rapidsai/nxcugraph-doc-codeowners
+**/*.ipynb         @rapidsai/nxcugraph-doc-codeowners
+**/*.pdf           @rapidsai/nxcugraph-doc-codeowners
+**/*.png           @rapidsai/nxcugraph-doc-codeowners
+
+#python code owners
+python/            @rapidsai/nxcugraph-python-codeowners
+
+#CI code owners
+/.github/                @rapidsai/ci-codeowners
+/ci/                     @rapidsai/ci-codeowners
+/.pre-commit-config.yaml @rapidsai/ci-codeowners
+
+#packaging code owners
+# /.devcontainer/  @rapidsai/packaging-codeowners
+/conda/            @rapidsai/packaging-codeowners
+/dependencies.yaml @rapidsai/packaging-codeowners
+/build.sh          @rapidsai/packaging-codeowners
+pyproject.toml     @rapidsai/packaging-codeowners

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,94 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# 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.
+
+name: Bug Report
+description: File a bug report for nx-cugraph
+title: "[BUG]: "
+labels: ["bug", "? - Needs Triage"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help nx-cugraph and fill out this bug report!
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of nx-cugraph are you running?
+      placeholder: "example: 22.12"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: installation-method
+    attributes:
+      label: Which installation method(s) does this occur on?
+      multiple: true
+      options:
+        - Conda
+        - Pip
+        - Source
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug.
+      description: Also tell us, what did you expect to happen?
+      placeholder: XYZ occured, I expected QRS results
+    validations:
+      required: true
+
+  - type: textarea
+    id: mvr
+    attributes:
+      label: Minimum reproducible example
+      description: Please supply a [minimum reproducible code example](https://matthewrocklin.com/blog/work/2018/02/28/minimal-bug-reports) here
+      render: shell
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please paste relevant error and log output here
+      render: shell
+
+  - type: textarea
+    id: env-details
+    attributes:
+      label: Environment details
+      description: Please provide any relevant environment details
+      placeholder: |
+        Please run and paste the output of the `nx-cugraph/print_env.sh` script here.
+        The script gathers any other relevant environment details.
+      render: shell
+
+  - type: textarea
+    id: misc
+    attributes:
+      label: Other/Misc.
+      description: Please enter any other helpful information here.
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://docs.rapids.ai/resources/conduct/)
+      options:
+        - label: I agree to follow nx-cugraph's Code of Conduct
+          required: true
+        - label: I have searched the [open bugs](https://github.com/rapidsai/nx-cugraph/issues?q=is%3Aopen+is%3Aissue+label%3Abug) and have found no duplicates for this bug report
+          required: true

.github/ISSUE_TEMPLATE/docs_request_correction.yaml

@@ -0,0 +1,70 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# 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.
+
+name: Documentation - Correction/Update Request
+description: Request corrections or updates to existing nx-cugraph documentation
+title: "[DOC]: "
+labels: ["doc", "? - Needs Triage"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help nx-cugraph and improve our documentation!
+
+  - type: dropdown
+    id: criticality
+    attributes:
+      label: How would you describe the priority of this documentation request
+      options:
+        - Critical (currently preventing usage)
+        - High
+        - Medium
+        - Low (would be nice)
+    validations:
+      required: true
+
+  - type: input
+    id: correction_location
+    attributes:
+      label: Please provide a link or source to the relevant docs
+      placeholder: "ex: https://docs.rapids.ai/api/cugraph/stable/installation/"
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Describe the problems in the documentation
+      placeholder: The documents say to use foo.func(args) however an AttributeError is thrown
+    validations:
+      required: true
+
+  - type: textarea
+    id: correction
+    attributes:
+      label: (Optional) Propose a correction
+      placeholder: foo.func() was deprecated, replace documentation with foo.new_func()
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://docs.rapids.ai/resources/conduct/)
+      options:
+        - label: I agree to follow nx-cugraph's Code of Conduct
+          required: true
+        - label: I have searched the [open documentation issues](https://github.com/rapidsai/nx-cugraph/issues?q=is%3Aopen+is%3Aissue+label%3Adoc) and have found no duplicates for this bug report
+          required: true

.github/ISSUE_TEMPLATE/docs_request_new.yaml

@@ -0,0 +1,64 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# 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.
+
+name: Documentation - New Documentation Request
+description: Request additions to nx-cugraph's documentation
+title: "[DOC]: "
+labels: ["doc", "? - Needs Triage"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help nx-cugraph and improve our documentation!
+
+  - type: dropdown
+    id: criticality
+    attributes:
+      label: How would you describe the priority of this documentation request
+      options:
+        - Critical (currently preventing usage)
+        - High
+        - Medium
+        - Low (would be nice)
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Describe the future/missing documentation
+      placeholder: A code snippet mentions function foo(args) but I cannot find any documentation on it.
+    validations:
+      required: true
+
+  - type: textarea
+    id: search_locs
+    attributes:
+      label: Where have you looked?
+      placeholder: |
+       https://docs.rapids.ai/api/cugraph/stable/nx_cugraph and
+       https://docs.rapids.ai/api/cugraph/nightly/nx_cugraph
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://docs.rapids.ai/resources/conduct/)
+      options:
+        - label: I agree to follow nx-cugraph's Code of Conduct
+          required: true
+        - label: I have searched the [open documentation issues](https://github.com/rapidsai/nx-cugraph/issues?q=is%3Aopen+is%3Aissue+label%3Adoc) and have found no duplicates for this bug report
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,95 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# 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.
+
+name: Feature Request Form
+description: Request new or improved functionality or changes to existing nx-cugraph functionality
+title: "[FEA]: "
+labels: ["feature request", "? - Needs Triage"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help nx-cugraph and fill out this feature request!
+
+  - type: dropdown
+    id: new_or_improvement
+    attributes:
+      label: Is this a new feature, an improvement, or a change to existing functionality?
+      options:
+        - New Feature
+        - Improvement
+        - Change
+    validations:
+      required: true
+
+  - type: dropdown
+    id: criticality
+    attributes:
+      label: How would you describe the priority of this feature request
+      options:
+        - Critical (currently preventing usage)
+        - High
+        - Medium
+        - Low (would be nice)
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Please provide a clear description of problem this feature solves
+      description: Real usage examples are especially helpful, non-code.
+      placeholder: I want nx-cugraph to do _____, because I need to _____.
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe your ideal solution
+      description: Please describe the functionality you would like added.
+      placeholder: >
+        A new function that takes in the information in this form, and triages the issue
+
+        def feature_request(form_info):
+            parse(form_info)
+            return triage_outcome
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe any alternatives you have considered
+      description: List any other libraries, or approaches you have looked at or tried.
+      placeholder: I have looked at library xyz and qrs, but they do not offer GPU accleration
+
+  - type: textarea
+    id: misc
+    attributes:
+      label: Additional context
+      description: Add any other context, code examples, or references to existing implementations about the feature request here.
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://docs.rapids.ai/resources/conduct/)
+      options:
+        - label: I agree to follow nx-cugraph's Code of Conduct
+          required: true
+        - label: I have searched the [open feature requests](https://github.com/rapidsai/nx-cugraph/issues?q=is%3Aopen+is%3Aissue+label%3A%22feature+request%22%2Cimprovement%2Cenhancement) and have found no duplicates for this feature request
+          required: true