4
4
5
5
The Rust project maintains two blogs.
6
6
The “main blog” ([ blog.rust-lang.org] ( https://blog.rust-lang.org/index.html ) )
7
- and a “team blog”
7
+ and a “inside Rust blog”
8
8
([ blog.rust-lang.org/inside-rust] ( https://blog.rust-lang.org/inside-rust/ ) ).
9
9
This document provides the guidelines for what it takes to write
10
10
a post for each of those blogs, as well as how to propose a post and to choose which blog is most
@@ -18,7 +18,7 @@ Ultimately, there are three options:
18
18
- The main Rust blog
19
19
- Suitable when your audience is “all Rust users or potential users”
20
20
- Written from an “official position”, even if signed by an individual
21
- - The team Rust blog
21
+ - The inside Rust blog
22
22
- Suitable when your audience is “all Rust contributors or potential contributors”
23
23
- Written from an “official position”, even if signed by an individual
24
24
- Your own personal blog
@@ -42,10 +42,10 @@ describing an exciting project, but again in a way that represents the project a
42
42
Manish Goregaokar’s report on [ Fearless Concurrency in Firefox
43
43
Quantum] ( https://blog.rust-lang.org/2017/11/14/Fearless-Concurrency-In-Firefox-Quantum.html ) ).
44
44
45
- To decide between the main blog and the team blog, the question to ask yourself is ** who is the
45
+ To decide between the main blog and the inside Rust blog, the question to ask yourself is ** who is the
46
46
audience** for your post. Posts on the main blog should be targeting ** all** Rust users or
47
47
potential users — they tend to be lighter on technical detail, and written without requiring as
48
- much context. Posts on the team blog can assume a lot more context and familiarity with Rust.
48
+ much context. Posts on the inside Rust blog can assume a lot more context and familiarity with Rust.
49
49
50
50
## Writing for the Main Rust blog
51
51
@@ -55,10 +55,6 @@ Post proposals describing exciting developments from within the Rust org are wel
55
55
posts that describe exciting applications of Rust. We do not generally do “promotional
56
56
cross-posting” with other projects, however.
57
57
58
- If you would like to propose a blog post for the main blog,
59
- please reach out to a [ Leadership Council member] ( https://www.rust-lang.org/governance/teams/leadership-council ) .
60
- It is not suggested to just open PRs against the main Rust blog that add posts without first discussing it with a Leadership Council member.
61
-
62
58
### Release note blog posts
63
59
64
60
One special case are the regular release note posts that accompany every Rust release. These are
@@ -79,15 +75,62 @@ Before publishing a release post, it goes through a drafting process:
79
75
80
76
[ 1.39.0 ] : https://github.com/rust-lang/rust/milestone/66?closed=1
81
77
82
- ## Team Rust blogs
78
+ ## Inside Rust blogs
83
79
84
- Teams can generally decide for themselves what to write on the team Rust blog.
80
+ Teams can generally decide for themselves what to write on the inside Rust blog.
85
81
86
- Typical subjects for team Rust blog posts include:
82
+ Typical subjects for inside Rust blog posts include:
87
83
88
84
- New initiatives and calls for participation
89
85
- Updates and status reports from ongoing work
90
86
- Design notes
91
87
92
- To propose a blog post for the team blog of a particular team, reach out to the team lead or some
93
- other team representative.
88
+ ## Approval process
89
+
90
+ For both the inside Rust and main blogs, we require an approval from:
91
+
92
+ * Any team lead (top level or not)
93
+ * Any leadership council member
94
+ * Rust Foundation project director
95
+
96
+ These are primarily the members of the
97
+ [ inside-rust-reviewers] ( https://github.com/rust-lang/team/blob/master/teams/inside-rust-reviewers.toml )
98
+ marker team[ ^ 1 ] . Note that this applies to * both* the main and inside Rust blogs
99
+ (renaming will happen at some later point).
100
+
101
+ [ ^ 1 ] : Release team members are also included there for release blog purposes,
102
+ but aren't considered eligible approvers for any random post at this time.
103
+
104
+ This approval should evaluate:
105
+
106
+ * Is the tone and content of the post appropriate for the official venue?
107
+ * For example, we should avoid negative commentary about other ecosystems/languages.
108
+ * Is it clear on whose behalf the post is written?
109
+ * This may not just be the by-line, but also the langauge used. If the post
110
+ takes official positions on behalf of the Rust Project as a whole, please
111
+ make sure at least one member of the leadership council signs off on it. If the
112
+ post is taking positions on behalf of a team, then that team should be in
113
+ agreement with the content.
114
+
115
+ In general, it's a good idea to make sure someone (not necessarily the approver
116
+ above) has proofread the post, but we generally prioritize unblocking posting
117
+ over perfect content for the blog. Note that the above generally does * NOT*
118
+ require that this person is a member of the team you're posting on behalf,
119
+ though they should be aware of the post.
120
+
121
+ ### Getting a review
122
+
123
+ Triagebot will automatically assign a leadership council representative to each
124
+ new blog PR. That representative is who you should ping if you're not getting a
125
+ review promptly, but you may get a faster review from asking team lead(s) for
126
+ their review as well. In other words, we recommend escalating to your team
127
+ lead(s), then pinging your team's leadership council representative, and
128
+ finally the assigned reviewer.
129
+
130
+ The assigned reviewer is ultimately responsible for making sure a review
131
+ happens.
132
+
133
+ Typically you should expect at least ~ 1 week of latency on initial review.
134
+ Re-review for any final edits or a final merge button press can usually be
135
+ promptly driven -- find a member of the group above available when you need to
136
+ merge the post.
0 commit comments