Skip to content

Commit 4fffea4

Browse files
Update Blog policy
1 parent 887206d commit 4fffea4

File tree

1 file changed

+56
-13
lines changed

1 file changed

+56
-13
lines changed

src/platforms/blogs.md

Lines changed: 56 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
The Rust project maintains two blogs.
66
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”
88
([blog.rust-lang.org/inside-rust](https://blog.rust-lang.org/inside-rust/)).
99
This document provides the guidelines for what it takes to write
1010
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:
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
4242
Manish Goregaokar’s report on [Fearless Concurrency in Firefox
4343
Quantum](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
4646
audience** for your post. Posts on the main blog should be targeting **all** Rust users or
4747
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.
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
5555
posts that describe exciting applications of Rust. We do not generally do “promotional
5656
cross-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

6460
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:
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

Comments
 (0)