github/ROCm
1
1
Fork 0
mirror of https://github.com/ROCm/ROCm.git synced 2026-04-05 03:01:17 -04:00
Code Issues Packages Projects Releases Wiki Activity
Files
3e833c73669fafeced18219904568c0a63272b50
ROCm/docs/contribute/contributing.md
Young Hui - AMD a29a457691 Merge develop into docs/6.1.0 (#3011) 
* added Getting ROCm Source Files (#2952)

* added Accessing ROCm Source Files

* changed per comments

* Update README.md

implement dgaliffi suggestions

Co-authored-by: David Galiffi <dgaliffi@amd.com>

* Update README.md

implement dgailifi suggestion

Co-authored-by: David Galiffi <dgaliffi@amd.com>

* Update README.md

implement dgailifi suggestion

Co-authored-by: David Galiffi <dgaliffi@amd.com>

* Update README.md

implement dgailifi suggestion

Co-authored-by: David Galiffi <dgaliffi@amd.com>

* add default.xml link

* update README

---------

Co-authored-by: David Galiffi <dgaliffi@amd.com>

* Bump rocm-docs-core from 0.35.1 to 0.36.0 in /docs/sphinx

Bumps [rocm-docs-core](https://github.com/RadeonOpenCompute/rocm-docs-core) from 0.35.1 to 0.36.0.
- [Release notes](https://github.com/RadeonOpenCompute/rocm-docs-core/releases)
- [Changelog](https://github.com/ROCm/rocm-docs-core/blob/develop/CHANGELOG.md)
- [Commits](https://github.com/RadeonOpenCompute/rocm-docs-core/compare/v0.35.1...v0.36.0)

---
updated-dependencies:
- dependency-name: rocm-docs-core
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

* Update rocAL link

* Add Radeon and Raden Pro specifications to the architecture reference (#2960)

* Expand architecture hardware specifications overview

Add supported Radeon and Radeon Pro GPUs

* Remove glossary from gpu architecture hardware specifications

* add reredirect extension
add redirection for openmp documentation

* Bump rocm-docs-core from 0.36.0 to 0.37.0 in /docs/sphinx

Bumps [rocm-docs-core](https://github.com/RadeonOpenCompute/rocm-docs-core) from 0.36.0 to 0.37.0.
- [Release notes](https://github.com/RadeonOpenCompute/rocm-docs-core/releases)
- [Changelog](https://github.com/ROCm/rocm-docs-core/blob/develop/CHANGELOG.md)
- [Commits](https://github.com/RadeonOpenCompute/rocm-docs-core/compare/v0.36.0...v0.37.0)

---
updated-dependencies:
- dependency-name: rocm-docs-core
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

* Update using-gpu-sanitizer.md (#2970)

* Update using-gpu-sanitizer.md

added the link text

Added the example

---------

Co-authored-by: Sam Wu <sam.wu2@amd.com>

* Update autotag README

* Add check for empty string in prev lib ver; also fix typo in ROCm

* Update what-is-rocm.rst (#2984)

* Bump rocm-docs-core from 0.37.0 to 0.38.0 in /docs/sphinx (#2986)

Bumps [rocm-docs-core](https://github.com/RadeonOpenCompute/rocm-docs-core) from 0.37.0 to 0.38.0.
- [Release notes](https://github.com/RadeonOpenCompute/rocm-docs-core/releases)
- [Changelog](https://github.com/ROCm/rocm-docs-core/blob/develop/CHANGELOG.md)
- [Commits](https://github.com/RadeonOpenCompute/rocm-docs-core/compare/v0.37.0...v0.38.0)

---
updated-dependencies:
- dependency-name: rocm-docs-core
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* minor update to the gpu-mpi section (#2983)

provide the precise parameters required to run Open MPI with libfabric and rocm
support.

* Update using-gpu-sanitizer.md (#2991)

* Update using-gpu-sanitizer.md

Minor OpenMP update

* Update using-gpu-sanitizer.md

Updated note with additional information.

* Update using-gpu-sanitizer.md

* Update using-gpu-sanitizer.md

Moved the note to another section

* Update using-gpu-sanitizer.md

* Bump rocm-docs-core from 0.38.0 to 0.38.1 in /docs/sphinx (#3004)

Bumps [rocm-docs-core](https://github.com/RadeonOpenCompute/rocm-docs-core) from 0.38.0 to 0.38.1.
- [Release notes](https://github.com/RadeonOpenCompute/rocm-docs-core/releases)
- [Changelog](https://github.com/ROCm/rocm-docs-core/blob/develop/CHANGELOG.md)
- [Commits](https://github.com/RadeonOpenCompute/rocm-docs-core/compare/v0.38.0...v0.38.1)

---
updated-dependencies:
- dependency-name: rocm-docs-core
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Bump idna from 3.4 to 3.7 in /docs/sphinx (#3007)

Bumps [idna](https://github.com/kjd/idna) from 3.4 to 3.7.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.rst)
- [Commits](https://github.com/kjd/idna/compare/v3.4...v3.7)

---
updated-dependencies:
- dependency-name: idna
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Reorganize "What is ROCm?" page (#3006)

* add rocm software stack diagram to What is ROCm landing page

* restructure ROCm project list table

* clean up unnecessary hyphenation

* update What is ROCm stack diagram filename

* reorder rocm project list to reflect diagram

* update "What is ROCm?" image metadata

* change 'project list' to 'components'

* change 'project' to 'component'

* Update codeowners (#3008)

* Update links (#2992)

* Update links

* table cleanup

* cross-refs

* wordlist update

* add temp hard links

* verbiage

* docs(index.md): Disable MD051 for Sphinx Markdown anchor point

In general this rule should be followed to avoid broken links

* revert gpu-arch table, remove dropdowns, quick start hyphen removedon index.md

* revise opening text as per PR comment

---------

Co-authored-by: Lisa <lisa.delaney@amd.com>
Co-authored-by: Sam Wu <sam.wu2@amd.com>
Co-authored-by: Young Hui <young.hui@amd.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: randyh62 <42045079+randyh62@users.noreply.github.com>
Co-authored-by: David Galiffi <dgaliffi@amd.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Sam Wu <sam.wu2@amd.com>
Co-authored-by: MKKnorr <matthias@streamhpc.com>
Co-authored-by: Bence Parajdi <bence@streamhpc.com>
Co-authored-by: Roopa Malavally <56051583+Rmalavally@users.noreply.github.com>
Co-authored-by: Lisa <lisa.delaney@amd.com>
Co-authored-by: Edgar Gabriel <edgargabriel@users.noreply.github.com>
Co-authored-by: peter <peter.park@amd.com>
Co-authored-by: Lisa <lisajdelaney@gmail.com>
2024-04-12 17:05:14 -04:00

5.0 KiB
Raw Blame History

<head> </head>

Contribute to ROCm documentation

All ROCm projects are GitHub-based, so if you want to contribute, you can do so by:

By creating a pull request (PR), you agree to allow your contribution to be licensed under the terms of the
LICENSE.txt file in the corresponding repository. Different repositories may use different licenses.

Submit a pull request

To make edits to our documentation via PR, follow these steps:

  1. Identify the repository and the file you want to update. For example, to update this page, you would need to modify content located in this file: https://github.com/ROCm/ROCm/blob/develop/docs/contribute/contributing.md

  2. (optional, but recommended) Fork the repository.

  3. Clone the repository locally and (optionally) add your fork. Select the green 'Code' button and copy the URL (e.g., git@github.com:ROCm/ROCm.git).

    • From your terminal, run:

      git clone git@github.com:ROCm/ROCm.git

    • Optionally add your fork to this local copy of the repository by running:

      git add remote <name-of-my-fork> <git@github.com:my-username/ROCm.git>

      To get the URL of your fork, go to your GitHub profile, select the fork and click the green 'Code' button (the same process you followed to get the main GitHub repository URL).

  4. Change directory into your local copy of the repository, and run git pull (or git pull origin develop) to ensure your local copy has the most recent content.

  5. Create and checkout a new branch using the following command:

    git checkout -b <branch_name>

  6. Change directory into the ./docs folder and make any documentation changes locally using your preferred code editor. Follow the guidelines listed on the documentation structure page.

  7. Optionally run a local test build of the documentation to ensure the content builds and looks as expected. In your terminal, run the following commands from within the ./docs folder of your cloned repository:

    pip3 install -r sphinx/requirements.txt  # You only need to run this command once
python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html

    The build output files are located in the docs/_build folder. To preview your build, open the index file (docs/_build/html/index.html) file. For more information, see Building documentation. To learn more about our build tools, see Documentation toolchain.

  8. Commit your changes and push them to GitHub by running:

    git add <path-to-my-modified-file> # To add all modified files, you can use: git add .
git commit -m "my-updates"
git push <name-of-my-fork>

    After pushing, you will get a GitHub link in the terminal output. Copy this link and paste it into a browser to create your PR.

Create an issue

  1. To create a new GitHub issue, select the 'Issues' tab in the appropriate repository (e.g., https://github.com/ROCm/ROCm/issues).
  2. Use the search bar to make sure the issue doesn't already exist.
  3. If your issue is not already listed, select the green 'New issue' button to the right of the page. Select the type of issue and fill in the resulting template.

General issue guidelines

  • Use your best judgement for issue creation. If your issue is already listed, upvote the issue and comment or post to provide additional details, such as how you reproduced this issue.
  • If you're not sure if your issue is the same, err on the side of caution and file your issue. You can add a comment to include the issue number (and link) for the similar issue. If we evaluate your issue as being the same as the existing issue, we'll close the duplicate.
  • If your issue doesn't exist, use the issue template to file a new issue.
    • When filing an issue, be sure to provide as much information as possible, including script output so we can collect information about your configuration. This helps reduce the time required to reproduce your issue.
    • Check your issue regularly, as we may require additional information to successfully reproduce the issue.

Suggest a new feature

Use the GitHub Discussion forum (Ideas category) to propose new features. Our maintainers are happy to provide direction and feedback on feature development.

Future development workflow

The current ROCm development workflow is GitHub-based. If, in the future, we change this platform, the tools and links may change. In this instance, we will update contribution guidelines accordingly.

Reference in New Issue View Git Blame Copy Permalink