Skip to content

Commit 2ac03b2

Browse files
committed
Libz Fixz
1 parent 09a5c14 commit 2ac03b2

File tree

1 file changed

+25
-29
lines changed

1 file changed

+25
-29
lines changed

_posts/2017-05-05-libz-blitz.md

Lines changed: 25 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ further improving discoverability on crates.io, [please start a thread]!
151151
### Rust standards of community
152152

153153
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 designthe Rust crate
154+
Rust library team is not the sole authority of Rust API designthe Rust crate
155155
ecosystem is created by all of us together and there are many lessons yet to
156156
learn. In recognition of that, **the library team is architecting our efforts to
157157
be as welcoming and inclusive as we can**.
@@ -166,18 +166,19 @@ API design principles, substantial missing functionality, planned API refactors,
166166
incomplete documentation, or any number of unique circumstances.
167167

168168
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.
175175

176176
[Air Mozilla]: https://air.mozilla.org/
177+
[Rust YouTube channel]: https://www.youtube.com/channel/UCaYhcUwRBNscFNUKTjgPFiA
177178

178179
We will have a rotating band of guests (including the crate authors) at the
179180
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
181182
among the same.
182183

183184
Based on the evaluations and library team review, we will file issues that we
@@ -188,24 +189,25 @@ contributions**.
188189
Here are the issues that arose from the very simple [`byteorder`]
189190
crate (all resolved now):
190191

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)
198199

199200
Beyond `byteorder` we've already worked this process for several other simple
200201
crates to get a feel for it: [`bitflags`], [`tempdir`], [`flate2`], and
201202
[`lazy_static`]. Even these, the most basic of crates, have some work left to do
202203
but you can expect them to have "1.0" releases soon. As the crates under
203204
evaluation grow in scope, presumably the tasks that arise will grow as well.
204205

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
206208
[`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
209211

210212

211213
### What crates are we going to focus on?
@@ -273,7 +275,9 @@ Roles that need your help:
273275
effort. That entails starting up a thread, breaking up the evaluation work
274276
into small work items that can be taken on by others in the community, keeping
275277
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.
277281

278282
*Anyone can be a crate lead, but it's a substantial commitment and is largely
279283
about organization, communication, and consensus, and requires presenting to
@@ -295,7 +299,8 @@ Roles that need your help:
295299
full quality is improving documentation, including writing up cookbook entries.
296300
There will be lots of opportunities for this kind of high value work.
297301

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.*
299304

300305
- **Library hacker**. Somebody must do the programming work of resolving the
301306
issues on the roadmap to stability for each crate. We expect to produce many
@@ -349,12 +354,3 @@ Here's the plan:
349354
Come help us make this happen!
350355

351356
[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

Comments
 (0)