# `π» opensource-template`
**Template for creating new open source repositories that follow the Embark open source guidelines**
[![Embark](https://img.shields.io/badge/embark-open%20source-blueviolet.svg)](https://embark.dev)
[![Embark](https://img.shields.io/badge/discord-ark-%237289da.svg?logo=discord)](https://discord.gg/dAuKfZS)
[![Crates.io](https://img.shields.io/crates/v/rust-gpu.svg)](https://crates.io/crates/rust-gpu)
[![Docs](https://docs.rs/rust-gpu/badge.svg)](https://docs.rs/rust-gpu)
[![Git Docs](https://img.shields.io/badge/git%20main%20docs-published-blue)](https://embarkstudios.github.io/presser/presser/index.html)
[![dependency status](https://deps.rs/repo/github/EmbarkStudios/rust-gpu/status.svg)](https://deps.rs/repo/github/EmbarkStudios/rust-gpu)
[![Build status](https://github.com/EmbarkStudios/physx-rs/workflows/CI/badge.svg)](https://github.com/EmbarkStudios/physx-rs/actions)
TEMPLATE INSTRUCTIONS
- Create a new repository under EmbarkStudios using this template.
- Title: Change the first line of this README to the name of your project, and replace the sunflower with an emoji that represents your project. π¨ Your emoji selection is critical.
- Badges: In the badges section above, change the repo name in each URL. If you are creating something other than a Rust crate, remove the crates.io and docs badges (and feel free to add more appropriate ones for your language).
- CI: In
./github/workflows/
rename rust-ci.yml
(or the appropriate config for your language) to ci.yml
. And go over it and adapt it to work for your project
- If you aren't using or customized the CI workflow, also see the TODO in
.mergify.yml
- If you want to use the automatic rustdoc publishing to github pages for git main, see
rustdoc-pages.yml
- Issue & PR Templates: Review the files in
.github/ISSUE_TEMPLATE
and .github/pull_request_template
. Adapt them
to suit your needs, removing or re-wording any sections that don't make sense for your use case.
- CHANGELOG.md: Change the
$REPO_NAME
in the links at the bottom to the name of the repository, and replace the example template lines with the actual notes for the repository/crate.
- release.toml: in
./release.toml
change the $REPO_NAME
to the name of the repository
- Cleanup: Remove this section of the README and any unused files (such as configs for other languages) from the repo.
Contributing
We welcome community contributions to this project.
Please read our Contributor Guide for more information on how to get started.
Please also read our Contributor Terms before you make any contributions.
Any contribution intentionally submitted for inclusion in an Embark Studios project, shall comply with the Rust standard licensing model (MIT OR Apache 2.0) and therefore be dual licensed as described below, without any additional terms or conditions:
License
This contribution is dual licensed under EITHER OF
at your option.
For clarity, "your" refers to Embark or any other licensee/user of the contribution.