Skip to content

Commit 0b97be1

Browse files
authored
Merge pull request #1 from lcnr/initial
initial group description
2 parents 1980745 + d7e1fe3 commit 0b97be1

File tree

2 files changed

+45
-73
lines changed

2 files changed

+45
-73
lines changed

CHARTER.md

+10-25
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,17 @@
1-
# {{GROUP_NAME}} Charter
2-
<!--
3-
Provide an introduction summarising the goals and motivation behind your
4-
project group.
5-
-->
1+
# Const Generics Charter
62

7-
## Goals
8-
9-
<!--
10-
Explain what changes you'd like to see your group your group to focus on, and
11-
how you plan to approach these issues. Focus on explaining the highest possible
12-
level of your change.
13-
-->
3+
The goal of this group is to both improve and extend the support for const generics.
144

15-
## Constraints And Considerations
5+
## Goals
166

17-
<!--
18-
Explain the scope of your group, what you have chosen not to include in
19-
your goals, and your motivations behind making them non-goals.
20-
-->
7+
Improving the user experience when using and working on const generics. This includes both improvements to diagnostics for the already stabilized parts as well as adding new features:
218

9+
- const param defaults `struct Foo<const N: usize = 3>`
10+
- more const param types, most importantly user defined types and `&'static str`
11+
- allowing complex generic operations in constants
2212

23-
## Membership
13+
## Constraints And Considerations
2414

25-
<!--
26-
Mention your initial membership and who has decided take the roles of
27-
shepherd(s) and liason.
28-
-->
15+
At least for the near future, we will mostly focus on the items mentioned above.
2916

30-
**Shepherd:**
31-
**Team Liason:**
32-
**Members:**
17+
<!-- Why not just do everything, it's not like burnout is a problem in open source -->

README.md

+35-48
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,65 @@
1-
# {{GROUP_NAME}} {{GROUP_TYPE}} Group
2-
<!--
3-
This is the template for creating project groups in rust-lang. Be sure to go
4-
through all sections marked with `**FIX ME**`, and make sure that the text is
5-
correct, and feel free to replace/remove any part that's not relevant to
6-
your group.
7-
8-
All of the text across all of the initial files uses the same group of
9-
variables to allow for easy search and replace. They are listed below.
10-
11-
Example sed command: `sed -i '' 's/{{GROUP_NAME}}/Inline ASM/g' ./**/*.md`
12-
*Note* the `-i ''` is important as it is required on some platforms e.g. macOS
13-
14-
* {{GROUP_NAME}} -> The display name of your group e.g. "Inline ASM".
15-
* {{GROUP_SLUG}} -> The url slug name of your group used for
16-
`rust-lang/team` and repo name. e.g. "pg-inline-asm".
17-
* {{CHAT_PLATFORM}} -> The name of your chat app e.g. "Zulip".
18-
* {{CHAT_LINK}} -> The hyperlink to your discussions on the chat app
19-
e.g. "https://rust-lang.zulipchat.com/#narrow/stream/216763-project-inline-asm".
20-
-->
1+
# Const Generics Project Group
212

223
<!--
234
Status badge advertising the project as being actively worked on. When the
245
project has finished be sure to replace the active badge with a badge
256
like: https://img.shields.io/badge/status-archived-grey.svg
267
-->
278
![project group status: active](https://img.shields.io/badge/status-active-brightgreen.svg)
9+
<!--
10+
FIXME(website)
2811
[![project group documentation](https://img.shields.io/badge/MDBook-View%20Documentation-blue)][gh-pages]
29-
30-
31-
**FIX ME**
12+
-->
13+
The const generics project group implements and designs the `const_generics` feature. Please refer to our [charter] for more information on our goals and current scope.
14+
15+
Examples:
16+
17+
```rust
18+
struct Foo<const N: usize> {
19+
field: [u8; N],
20+
}
21+
22+
fn foo<const N: usize>() -> Foo<N> {
23+
Foo {
24+
field: [0; N],
25+
}
26+
}
27+
28+
fn main() {
29+
match foo::<3>().field {
30+
[0, 0, 0] => {} // ok
31+
[_x, _y, _z] => panic!(),
32+
}
33+
}
34+
```
3235

3336
<!--
34-
Provide a short introduction about your project group. Make sure to include any
35-
relevant links to information about your group.
36-
-->
37+
FIXME(website): do we want a website for this?
3738
38-
Welcome to the repository for the {{GROUP_NAME}} Project Group! This is the
39+
Welcome to the repository for the Const Generics Project Group! This is the
3940
repository we use to organise our work. Please refer to our [charter] as well
4041
as our [github pages website][gh-pages] for more information on our goals and
4142
current scope.
42-
43-
[charter]: ./CHARTER.md
4443
[gh-pages]: https://rust-lang.github.io/{{GROUP_SLUG}}
4544
46-
**/FIX ME**
4745
46+
**/FIX ME**
47+
-->
4848

49-
## How Can I Get Involved?
49+
[charter]: ./CHARTER.md
5050

51-
**FIX ME**
5251

53-
<!--
54-
List ways that people from outside your group can get involved and potentially
55-
become members, include what meetings your team has, and how a person could
56-
start participating and contributing. Make sure to mention the main platform
57-
your group hosts its discussions. Be sure to also include links to any
58-
other projects that your group maintains.
59-
-->
52+
## How Can I Get Involved?
6053

6154
[You can find a list of the current members available
6255
on `rust-lang/team`.][team-toml]
6356

64-
If you'd like to participate be sure to check out any of our [open issues] on this
65-
repository.
66-
67-
We also participate on [{{CHAT_PLATFORM}}][chat-link], feel free to introduce
57+
If you'd like to participate be sure to check out the relevant stream on [zulip][chat-link], feel free to introduce
6858
yourself over there and ask us any questions you have.
6959

70-
7160
[open issues]: /issues
72-
[chat-link]: {{CHAT_LINK}}
73-
[team-toml]: https://github.com/rust-lang/team/blob/master/teams/{{GROUP_TYPE}}-{{GROUP_SLUG}}.toml
74-
75-
**/FIX ME**
61+
[chat-link]: https://rust-lang.zulipchat.com/#narrow/stream/260443-project-const-generics
62+
[team-toml]: https://github.com/rust-lang/team/blob/master/teams/project-const-generics.toml
7663

7764
## Building Documentation
7865
This repository is also an mdbook project. You can view and build it using the

0 commit comments

Comments
 (0)