Skip to content

Commit 7a2bb36

Browse files
committed
Fix README markdown lints
1 parent 116bf9c commit 7a2bb36

File tree

1 file changed

+19
-10
lines changed

1 file changed

+19
-10
lines changed

README.md

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,27 @@
1+
<!-- Allow this file to not have a first line heading -->
2+
<!-- markdownlint-disable-file MD041 -->
3+
<!-- Disable warning om emphasis after first heading -->
4+
<!-- markdownlint-disable-file MD036 -->
5+
6+
<!-- inline html -->
7+
<!-- markdownlint-disable-file MD033 -->
8+
19
<div align="center">
210

311
# `🐉 rust-gpu`
412

5-
**Rust as a first-class language and ecosystem for GPU graphics & compute shaders**
6-
13+
**Rust as a first-class language and ecosystem for GPU graphics & compute shaders**
14+
715
[![Embark](https://img.shields.io/badge/embark-open%20source-blueviolet.svg)](https://embark.dev)
816
[![Discord](https://img.shields.io/badge/discord-ark-%237289da.svg?logo=discord)](https://discord.gg/dAuKfZS)
917
[![Documentation](https://img.shields.io/badge/docs-API-blue)](https://embarkstudios.github.io/rust-gpu/api/rustc_codegen_spirv)
1018
[![dependency status](https://deps.rs/repo/github/EmbarkStudios/rust-gpu/status.svg)](https://deps.rs/repo/github/EmbarkStudios/rust-gpu)
1119
[![Build status](https://github.com/EmbarkStudios/rust-gpu/workflows/Continuous%20integration/badge.svg?branch=main)](https://github.com/EmbarkStudios/rust-gpu/actions)
1220
</div>
13-
14-
### Current Status 🚧
1521

16-
Note: This project is still heavily in development and is at an early stage.
22+
## Current Status 🚧
23+
24+
Note: This project is still heavily in development and is at an early stage.
1725

1826
Compiling and running simple shaders works, and a significant portion of [the core library](https://doc.rust-lang.org/core/index.html) also compiles.
1927

@@ -22,7 +30,7 @@ However, many things aren't implemented yet. That means that while being technic
2230
[rust-support]: https://github.com/EmbarkStudios/rust-gpu/issues/78
2331
[spirv-support]: https://github.com/EmbarkStudios/rust-gpu/issues/383
2432

25-
### Example
33+
## Example
2634

2735
![Sky shader](docs/assets/sky.jpg)
2836

@@ -55,7 +63,7 @@ See [source](examples/shaders/sky-shader/src/lib.rs) for full details.
5563

5664
## Our Vision & Community Contributions
5765

58-
`rust-gpu` is a project that we at Embark think has the potential to change the way GPU programming works in multiple ways. One of the primary things we think it can change is opening the door to leverage the open source culture of sharing and improving each others' code, and our end goal and vision for `rust-gpu` is to develop it very much in tandem with the community. However, the project is still in quite early stages and has a very small team working on it, so in order to be productive and guide the project to where we ultimately want it to go, as of right now, we need to focus on our own primary use cases for our projects at Embark.
66+
`rust-gpu` is a project that we at Embark think has the potential to change the way GPU programming works in multiple ways. One of the primary things we think it can change is opening the door to leverage the open source culture of sharing and improving each others' code, and our end goal and vision for `rust-gpu` is to develop it very much in tandem with the community. However, the project is still in quite early stages and has a very small team working on it, so in order to be productive and guide the project to where we ultimately want it to go, as of right now, we need to focus on our own primary use cases for our projects at Embark.
5967

6068
What this means practically is that it is unlikely that we'll be able to accept major changes from community members at this time. If you have a large change you would like to make, please file an issue and/or ask on our Discord in the `#rust-gpu` channel to see if it is something we'll be able to accept *before* working on it, as it is not great to have to turn down stuff that community members have poured their time and effort into. As the project matures, we'll in theory be able to accept more input from the community and move closer and closer to the goals outlined above. Thank you so much for your understanding!
6169

@@ -68,7 +76,6 @@ Experiment with rust-gpu shaders in-browser at [SHADERed][shadered].
6876
[gpu-guide]: https://embarkstudios.github.io/rust-gpu/book/
6977
[shadered]: https://shadered.org/shaders?language=rust&sort=hot
7078

71-
7279
## Background
7380

7481
Historically in games GPU programming has been done through writing either HLSL, or to a lesser extent GLSL. These are simple programming languages that have evolved along with rendering APIs over the years. However, as game engines have evolved, these languages have failed to provide mechanisms for dealing with large codebases, and have generally stayed behind the curve compared to other programming languages.
@@ -119,7 +126,9 @@ There are a few different components to this repo:
119126
- [spirv-builder](crates/spirv-builder) for a convenient way of building a GPU crate in a CPU build.rs file.
120127

121128
## Related Projects
129+
122130
Historical and other related projects for compiling Rust code to GPUs.
131+
123132
- 2016: [glassful](https://github.com/kmcallister/glassful) Compiles a subset of Rust to GLSL.
124133
- 2017: [inspirv-rust](https://github.com/msiglreith/inspirv-rust) Experimental Rust to SPIR-V compiler.
125134
- 2018: [nvptx](https://github.com/japaric-archived/nvptx) Rust to PTX compiler.
@@ -139,8 +148,8 @@ Please read our [Contributor Guide](CONTRIBUTING.md) for more information on how
139148

140149
Licensed under either of
141150

142-
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
143-
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
151+
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
152+
- MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>)
144153

145154
at your option.
146155

0 commit comments

Comments
 (0)