Skip to content

create the "Inside Rust" blog #406

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Oct 3, 2019

Conversation

nikomatsakis
Copy link
Contributor

@nikomatsakis nikomatsakis commented Sep 25, 2019

This PR creates the "Rust Team Blog", which will be visible at blog.rust-lang.org/team. This is a draft PR because I'd like to resolve a few questions:

  • prep an announcement blog post for the main blog
  • Settled the name ("Inside Rust" wins!)
  • Modify PR to use the "Inside Rust" name and adjust other things
  • How should we expose this blog on the site? Right now, you'd just have to guess the URL.
    • I'm not sure this has to block us from deploying the blog now though -- there is a lot of demand to have a place
  • I added an ad-hoc tag team: core to the first post -- I'd like each post to be tagged with a team, and ideally I'd like that to be visible in the post (and to enable filtering by team/working group). Can we at least enforce that we have a team: tag somewhere for now?
  • Any thoughts on the other "front matter" in the blog.yml file? (e.g., tagphrase)
  • And of course any thoughts on the text of the inaugural post itself?
  • A draft of blog policies are visible here blog policies wg-governance#23
  • Remove "dual layout" system and replace with a change to blog configuration.

@rust-highfive
Copy link

r? @alexcrichton

(rust_highfive has picked a reviewer for you, use r? to override)

@nikomatsakis
Copy link
Contributor Author

cc @rust-lang/core

@Mark-Simulacrum
Copy link
Member

"Rust internals" blog, perhaps? To mirror users.rust-lang.org vs internals.rust-lang.org -- though I'll admit that distinction isn't super clear either.

@pietroalbini
Copy link
Member

Maybe "Inside Rust"?

@steveklabnik
Copy link
Member

I was very confused when I saw the email for this appear in my inbox, given that I already think of the blog as the "rust team blog." So 👍 to a different name.

I think "development blog" would be fine. I also like the "internals blog" idea; I agree the users/internals split isn't always super obvious, but I think it's probably fine.

@nikomatsakis
Copy link
Contributor Author

nikomatsakis commented Sep 26, 2019

Another thought I had was the "Rust Teams blog" -- using the plural there kind of makes it sound mildly
different to me. I guess that "Rust Team" and "Rust Project" feel more analogous and that Rust Teams is kind of more clearly "Blog for the Rust teams". Still, it's not a big change.

Anyway, my main concern with the name internals is that it sounds like the blog is about the internals of Rust, which, I guess it is, but only from a certain POV. (Feels a lot like "dev blog" to me.)

Another thought: give it a more creative name, like "Inside the Rust project"? "Rust insider's blog" (that sounds exclusive).

Final thought: Just use the main blog for everything? :) But I still think it's useful to have a separate channel, it'll encourage us to post a lot more stuff on here (e.g., it would feel weird for me to post minutes from compiler team meetings on the main blog, right? But I intend to start posting those here.)

EDIT: I see @pietroalbini and I were coming to a similar theme with the "Inside" concept.

@nikomatsakis
Copy link
Contributor Author

Updated the main issue with the names proposed thus far. I'd definitely like to get this setup because I have an announcement I want to post. =) I guess most any name will work out ok.

@wesleywiser
Copy link
Member

When I first saw mentions of the team blog, I assumed each team was getting their own blog. IE, blog.rlo/compiler for the compiler team, blog.rlo/lang for the lang team, blog.rlo/community for the community team, etc. Perhaps that idea is worth exploring more?

I think there's some interesting advantages to that idea:

  • Resolves the naming issue, obviously.
  • Allows each blog to be more targeted for its audience. For example, a dedicated compiler team blog could be used to advertise large scale changes to rustc that impact contributors but are of little interest to most others.
    • Periodically, the compiler team also has issues it wants to broadcast more widely and ask for help from the community with. A dedicated blog would be a good place to mention those.
  • Implicitly has the "ad hoc team tag" you mention by virtue of each team having their own blog.
  • Can be advertised from the Governance pages for each team.

@nikomatsakis
Copy link
Contributor Author

@wesleywiser Yeah, I definitely considered that, but it seems to be rather a lot of blogs, and I worry that they smaller teams or working groups won't get as much "circulation" this way. I think in my ideal world you'd be able to pick-and-choose the teams you want to "follow".

Still, it would resolve the naming issue, it's true. =)

Periodically, the compiler team also has issues it wants to broadcast more widely and ask for help from the community with. A dedicated blog would be a good place to mention those.

I absolutely expect to post those on this blog, along with meeting notes and the like, and posts from smaller groups like self-profile. If people think that would be inappropriate for a single blog, then I agree we should shift.

@nikomatsakis
Copy link
Contributor Author

(The other thing is that I think a lot of posts will be kind of "cross-team" -- e.g., are async-await updates lang, or compiler?)

@nikomatsakis
Copy link
Contributor Author

OK! I propose people give their opinion on one of two possibilities:

  • name the blog "Inside Rust" (add 🎉 emoji)
  • create per-team / per-working-group blogs (add 🚀 emoji)

I don't know which one I prefer. Some thoughts here and here. Feel free to leave your own.

@steveklabnik
Copy link
Member

An additional possible per-blog option is to create tags, and have them be on the same blog, but you could filter by tag.

@nikomatsakis
Copy link
Contributor Author

@steveklabnik yep, that's what I was hoping we would do.

Also worth pointing out: this is not an irreversible decision. We can always break out sub-blogs later, or add special urls that filter by tag.

@nikomatsakis
Copy link
Contributor Author

nikomatsakis commented Sep 27, 2019

OK, it seems like the "poll" has spoken:

image

"Inside Rust" it is! I think the plan is that we'll enforce the team: tags (informally, perhaps, to start) and at some point enable filtering in the UI (and perhaps RSS feeds or whatever as well (do people still use RSS?)). I'll take a look later to see how hard it would be to reject posts without the team: tags, can't be that hard, right?

I think the only other major question that we probably want to settle before deploying is:

How should we expose this blog on the site? Right now, you'd just have to guess the URL.

Of course we don't have to link the site from the main page, but it seems like it'd be nice to. @skade @Manishearth, any thoughts on this? Should I just take a stab to see if I can figure out how to add it to that "main list" at the top of the site of pages? (i.e., next to "Blog") It feels like a major change to the site UI that might get kind of "busy".

@nikomatsakis nikomatsakis changed the title create the Rust Team blog create the "Inside Rust" blog Sep 27, 2019
@skade
Copy link
Contributor

skade commented Sep 27, 2019

We should link it from the page somewhere.

@nikomatsakis
Copy link
Contributor Author

Hmm, we no longer have a "contribute page", right?

@nikomatsakis
Copy link
Contributor Author

nikomatsakis commented Sep 27, 2019

But maybe we can link to it from the Governance and Community pages, or something?

(For example, near the list of teams)

@nikomatsakis nikomatsakis force-pushed the rust-team-blog branch 2 times, most recently from 81d7a09 to aed3a79 Compare September 27, 2019 16:34
@nikomatsakis
Copy link
Contributor Author

OK, I went a little crazy, and upgraded the code a bit to respect the team and team_url metadata, and incorporated that into the layout:

image

This is about the limit of my web-design skills.

I decided against making team an enum because I didn't want to add PRs to the blog each time some new team wants to publish or whatever. On the other hand, maybe just saying "core" is a bit terse. I don't know, seems ok for now, we can improve.

@nikomatsakis
Copy link
Contributor Author

So, the only question is how to incorporate this into the main site -- and @skade I realize now that this is not something we can do in this PR anyway.

The URL would be blog.rust-lang.org/inside-rust, I believe.

@nikomatsakis
Copy link
Contributor Author

r? @pietroalbini on the code changes

@nikomatsakis
Copy link
Contributor Author

or maybe @steveklabnik =)

@nikomatsakis
Copy link
Contributor Author

Idea: I will look into creating a link to the Inside Rust blog from the main blog header or something also, since it seems likely people would try to navigate that way. That plus a link on governance page seems good.

@pietroalbini
Copy link
Member

Yeah, a required_team: true in the blog config could work.

@nikomatsakis nikomatsakis marked this pull request as ready for review September 30, 2019 14:03
@nikomatsakis
Copy link
Contributor Author

@pietroalbini ok I changed the setup as requested. There is still no link to the inside-rust blog from anywhere else, not sure what to do about that.

@nikomatsakis
Copy link
Contributor Author

nikomatsakis commented Sep 30, 2019

how it looks now
image

Along the way:

- blog post layouts are now mandatory, but must be "post"
- blog manifest specifies if the `team` attribute is required
- if so, it should have the format `team name <team-url>`
This...doesn't look great yet.
@nikomatsakis
Copy link
Contributor Author

nikomatsakis commented Sep 30, 2019

I added some code to list other blogs in the "posts index" page. It...doesn't look great yet. But maybe something similar could work.

image

@nikomatsakis
Copy link
Contributor Author

Probably it would look better in the upper-left corner :)

Copy link
Member

@pietroalbini pietroalbini left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Modulo that minor nit the code changes looks good to me! I defer to Florian or Manish for the design though.

Co-Authored-By: Pietro Albini <[email protected]>
@nikomatsakis
Copy link
Contributor Author

I think I'll revert the "see also" work I did, as I think it's pretty horrible looking.

@nikomatsakis
Copy link
Contributor Author

OK, I decided to take one more stab at the idea. I realized that the current "Posts" text was pretty minimal anyway and added the ability to customize the html that appears in the index. Now you have something like this:

image

and on the Inside Rust blog:

image

I've pushed those commits. Obviously would love feedback on the text itself!

@nrc
Copy link
Member

nrc commented Oct 2, 2019

In the Rust blog, maybe s/we/the core team to be consistent with the other blurb, otherwise lgtm

@nikomatsakis
Copy link
Contributor Author

OK -- I've pushed a few minor commits including an "Announcing the Inside Rust blog!" post for the main blog. I've dated that post for tomorrow, October 3rd, since I figured I'd rather announce this thing tomorrow vs tonight.

Therefore, if you've any last feedback, please make it known before tomorrow!

cc @rust-lang/core

I've dated it for tomorrow, since I don't plan to post it today.
@nikomatsakis
Copy link
Contributor Author

OK, I'm going to pull the trigger here!

@nikomatsakis nikomatsakis merged commit f01aa85 into rust-lang:master Oct 3, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

9 participants