@@ -151,7 +151,7 @@ further improving discoverability on crates.io, [please start a thread]!
151
151
### Rust standards of community
152
152
153
153
We have some idea of what goes into publishing exceptional Rust crates, but the
154
- Rust library team is not the sole authority of Rust API design— the Rust crate
154
+ Rust library team is not the sole authority of Rust API design — the Rust crate
155
155
ecosystem is created by all of us together and there are many lessons yet to
156
156
learn. In recognition of that, ** the library team is architecting our efforts to
157
157
be as welcoming and inclusive as we can** .
@@ -166,18 +166,19 @@ API design principles, substantial missing functionality, planned API refactors,
166
166
incomplete documentation, or any number of unique circumstances.
167
167
168
168
We'll have a small handful of such evaluations going on in parallel. Every two
169
- weeks, the library crate will take up one of the evaluations for discussion in
170
- our regular video conference, which will be recorded and made accessible on [ Air
171
- Mozilla] . One goal of these meetings will be to plan out a roadmap for
172
- stabilizing the crate in question. The other goal will be to identify any
173
- lessons to be learned from the crate and distill those into broadly applicable
174
- API guidelines.
169
+ weeks, the library team will take up one of the evaluations for discussion in
170
+ our regular video conference, which will be recorded and made available on [ Air
171
+ Mozilla] and the [ Rust YouTube channel ] . One goal of these meetings will be to
172
+ plan out a roadmap for stabilizing the crate in question. The other goal will be
173
+ to identify any lessons to be learned from the crate and distill those into
174
+ broadly applicable API guidelines.
175
175
176
176
[ Air Mozilla ] : https://air.mozilla.org/
177
+ [ Rust YouTube channel ] : https://www.youtube.com/channel/UCaYhcUwRBNscFNUKTjgPFiA
177
178
178
179
We will have a rotating band of guests (including the crate authors) at the
179
180
video conferences by invitation, in order to strengthen the bonds between the
180
- Rust team and the authors of the Rust ecosystem and to foster shared values
181
+ Rust team and the authors of the Rust ecosystem, and to foster shared values
181
182
among the same.
182
183
183
184
Based on the evaluations and library team review, we will file issues that we
@@ -188,24 +189,25 @@ contributions**.
188
189
Here are the issues that arose from the very simple [ ` byteorder ` ]
189
190
crate (all resolved now):
190
191
191
- - [x] [ Add a supertrait to hide trait details] ( https://github.com/BurntSushi/byteorder/issues/69 )
192
- - [x] [ ` ByteOrder::default ` should ` panic! ` not ` unreachable! ` ] ( https://github.com/BurntSushi/byteorder/issues/68 )
193
- - [x] [ Put panic and error docs in "Panics" and "Errors" sections] ( https://github.com/BurntSushi/byteorder/issues/72 )
194
- - [x] [ Make sure there are enough examples] ( https://github.com/BurntSushi/byteorder/issues/75 )
195
- - [x] [ Add CI badges to Cargo.toml] ( https://github.com/BurntSushi/byteorder/issues/74 )
196
- - [x] [ Add "categories" to Cargo.toml] ( https://github.com/BurntSushi/byteorder/issues/73 )
197
- - [x] [ Add ` #[doc(html_root_url)] ` ] ( https://github.com/BurntSushi/byteorder/issues/77 )
192
+ - [ Add a supertrait to hide trait details] ( https://github.com/BurntSushi/byteorder/issues/69 )
193
+ - [ ` ByteOrder::default ` should ` panic! ` not ` unreachable! ` ] ( https://github.com/BurntSushi/byteorder/issues/68 )
194
+ - [ Put panic and error docs in "Panics" and "Errors" sections] ( https://github.com/BurntSushi/byteorder/issues/72 )
195
+ - [ Make sure there are enough examples] ( https://github.com/BurntSushi/byteorder/issues/75 )
196
+ - [ Add CI badges to Cargo.toml] ( https://github.com/BurntSushi/byteorder/issues/74 )
197
+ - [ Add "categories" to Cargo.toml] ( https://github.com/BurntSushi/byteorder/issues/73 )
198
+ - [ Add ` #[doc(html_root_url)] ` ] ( https://github.com/BurntSushi/byteorder/issues/77 )
198
199
199
200
Beyond ` byteorder ` we've already worked this process for several other simple
200
201
crates to get a feel for it: [ ` bitflags ` ] , [ ` tempdir ` ] , [ ` flate2 ` ] , and
201
202
[ ` lazy_static ` ] . Even these, the most basic of crates, have some work left to do
202
203
but you can expect them to have "1.0" releases soon. As the crates under
203
204
evaluation grow in scope, presumably the tasks that arise will grow as well.
204
205
205
- [ `bitflags` ] : https://github.com/rust-lang-nursery/bitflags
206
+ [ `byteorder` ] : https://docs.rs/byteorder
207
+ [ `bitflags` ] : https://doc.rust-lang.org/tempdir/tempdir/index.html
206
208
[ `tempdir` ] : https://doc.rust-lang.org/tempdir/tempdir/index.html
207
- [ `flate2` ] : https://docs.rs/flate2
208
- [ `lazy_static` ] : https://docs. rs/lazy_static
209
+ [ `flate2` ] : https://github.com/rust-lang-nursery/bitflags
210
+ [ `lazy_static` ] : https://github.com/rust-lang-nursery/lazy-static. rs/issues/70
209
211
210
212
211
213
### What crates are we going to focus on?
@@ -273,7 +275,9 @@ Roles that need your help:
273
275
effort. That entails starting up a thread, breaking up the evaluation work
274
276
into small work items that can be taken on by others in the community, keeping
275
277
the discussion moving in productive directions, making sure the evaluation is
276
- completed on time, and finally, presenting the results at the libs team meeting.
278
+ completed on time, presenting the results at the libs team meeting, and,
279
+ finally, filing discrete, actionable issues on everything raised, and funneling
280
+ them to TWiR.
277
281
278
282
* Anyone can be a crate lead, but it's a substantial commitment and is largely
279
283
about organization, communication, and consensus, and requires presenting to
@@ -295,7 +299,8 @@ Roles that need your help:
295
299
full quality is improving documentation, including writing up cookbook entries.
296
300
There will be lots of opportunities for this kind of high value work.
297
301
298
- * Everyone is welcome to participate in this way at any time. The crate lead will help create opportunities to jump in.*
302
+ * Everyone is welcome to participate in this way at any time. The
303
+ crate lead will help create opportunities to jump in.*
299
304
300
305
- ** Library hacker** . Somebody must do the programming work of resolving the
301
306
issues on the roadmap to stability for each crate. We expect to produce many
@@ -349,12 +354,3 @@ Here's the plan:
349
354
Come help us make this happen!
350
355
351
356
[ crate cookbook ] : https://brson.github.io/rust-cookbook/
352
-
353
- [ regex ] : http://blog.burntsushi.net/ripgrep/
354
- [ webrender ] : https://air.mozilla.org/bay-area-rust-meetup-february-2016/
355
- [ `memmap` ] : https://github.com/danburkert/memmap-rs
356
- [ `tempdir` ] : https://doc.rust-lang.org/tempdir/tempdir/index.html
357
- [ `fs2` ] : https://github.com/danburkert/fs2-rs
358
- [ `byteorder` ] : https://docs.rs/byteorder
359
- [ `iron` ] : http://ironframework.io/doc/iron/
360
- [ `diesel` ] : https://diesel.rs/
0 commit comments