44
55The Rust project maintains two blogs.
66The “main blog” ([ blog.rust-lang.org] ( https://blog.rust-lang.org/index.html ) )
7- and a “team blog”
7+ and a “inside Rust blog”
88([ blog.rust-lang.org/inside-rust] ( https://blog.rust-lang.org/inside-rust/ ) ).
99This document provides the guidelines for what it takes to write
1010a 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:
1818- The main Rust blog
1919 - Suitable when your audience is “all Rust users or potential users”
2020 - Written from an “official position”, even if signed by an individual
21- - The team Rust blog
21+ - The inside Rust blog
2222 - Suitable when your audience is “all Rust contributors or potential contributors”
2323 - Written from an “official position”, even if signed by an individual
2424- Your own personal blog
@@ -42,10 +42,10 @@ describing an exciting project, but again in a way that represents the project a
4242Manish Goregaokar’s report on [ Fearless Concurrency in Firefox
4343Quantum] ( https://blog.rust-lang.org/2017/11/14/Fearless-Concurrency-In-Firefox-Quantum.html ) ).
4444
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
4646audience** for your post. Posts on the main blog should be targeting ** all** Rust users or
4747potential 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.
4949
5050## Writing for the Main Rust blog
5151
@@ -55,10 +55,6 @@ Post proposals describing exciting developments from within the Rust org are wel
5555posts that describe exciting applications of Rust. We do not generally do “promotional
5656cross-posting” with other projects, however.
5757
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-
6258### Release note blog posts
6359
6460One 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:
7975
8076[ 1.39.0 ] : https://github.com/rust-lang/rust/milestone/66?closed=1
8177
82- ## Team Rust blogs
78+ ## Inside Rust blogs
8379
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.
8581
86- Typical subjects for team Rust blog posts include:
82+ Typical subjects for inside Rust blog posts include:
8783
8884- New initiatives and calls for participation
8985- Updates and status reports from ongoing work
9086- Design notes
9187
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