rust-community / content-o-tron

A process for helping the Rust community and new comers to share their story of using Rust :robot:
Creative Commons Attribution Share Alike 4.0 International
18 stars 10 forks source link

Blogger starter kit ? #42

Open o0Ignition0o opened 6 years ago

o0Ignition0o commented 6 years ago

Blocked: awaiting discussion with Rust Community team about the possibility of taking ownership of the blogging template repo (edit by @booyaa)

TL;DR : Could we consider a "new blogger starter kit ?" This would probably include how to setup gh-pages or jekyll or any markdown supporting platform, how to get it hosted, get a domain name etc.

As part of trying to help newcomers doing their first Pull Request during the Outreachy project, we often had to explain how to work with github (how to rebase / squash commits, how to handle conflicts etc.). https://opensource.guide does an amazing job at providing an open source starter kit.

As a rookie blogger, I could be having lots of troubles "setting up" my blog : Should I go to Medium ? Should I rather publish markdown articles on gh-pages ? What is markdown and how am I supposed to work with it ? Can I embed links ? How could I promote my first articles ?

A resource on how to setup a blog to write and publish content could prove useful.

What do you think? Would it be a good idea, or is it a bit off topic since this project seems to rather focus on "post content" than on "meta post" things.

I might not be the most suited person to provide starter kit contents, but I'd sure love to help (and maybe I could blog about the process later ;) )

skade commented 6 years ago

Reflecting my chat comments: I really like that and people have used the Rust blog as a template informally before. A forkable template with setup instructions would be great!

We can consider moving this to the @rust-community/content-team repository or consider it part of content-o-tron.

booyaa commented 6 years ago

This is a great idea!

I would agree with @skade that this better suited as either part of the content-team repo or its own repo.

Once it’s been reviewed we could then transfer into the Rust community org?

adityac8 commented 6 years ago

Hey, @o0Ignition0o You could have a look at this blog. It is written by me and one of my friends who got into Outreachy. We can surely discuss more on the topic.

o0Ignition0o commented 6 years ago

I was actually looking for this link and couldn't find it anymore. Thanks a lot ! :D

o0Ignition0o commented 6 years ago

Ok so I have created a github-page with a sample blogpost and hosted the source code on a repo.

I've even been able to submit a PR to fix a CVE in the rustlang blog \o/

I plan on creating my own blog to explain the steps in order to setup the whole environment.

Should I continue here or move it all to the content-team repo ?

o0Ignition0o commented 6 years ago

http://blog.jeremylempereur.com/2018/05/10/blogception-create-blog-jekyll-github-pages-part-1.html

Here's the first part of a series which explains how to setup a blog from the boilerplate, I hope I'll be able to write part two (editing _config.yml and writing the first post) tonight :)

If there's anything I can edit to improve the post please let me know.

booyaa commented 6 years ago

@o0Ignition0o nice work! thanks for that rust-www (CVE) too!

I'm going to create raise with the main community about transferring repo to our org (as it implies ownership and on-going maintainance).

Please continue your blog post series, as I think I'm going to create another guide about setting up a blog and reference your posts (as well as the template repo).

I'm placing a blocked label so this item doesn't get closed accidentally.

o0Ignition0o commented 6 years ago

https://blog.jeremylempereur.com/2018/05/11/blogception-create-blog-jekyll-github-pages-part-2.html is out ! :D

Editing the _config.yml file, and writing the first blog post :)

Step 3 will probably come next week, and will probably include setting up gh pages, and using a custom domain name.

If you have any ideas on how to improve Section number 3 (to reflect more on the work that is being done here) please let me know, I would love to make it more inspiring !

booyaa commented 6 years ago

Discuss this with the whole community team, we're happy for you to transfer the ownership of the repo if you still want to do it. Just let us know when it's been done. Thanks!

o0Ignition0o commented 6 years ago

Sure, I'll do it by the end of the week \o/

Btw are there any things I should change before transferring ownership ? I could also maintain it a bit if need be :)

booyaa commented 6 years ago

We'll make sure you're still a collaborator/maintainer when it's transferred! :)

o0Ignition0o commented 6 years ago

Ok so i just tried to transfer it and I got an error

You don’t have the permission to create repositories on rust-community

o0Ignition0o commented 6 years ago

@booyaa do you have any idea on how I can transfer ownership of the repository ?

badboy commented 6 years ago

@o0Ignition0o Looking into that now

badboy commented 6 years ago

@o0Ignition0o See https://help.github.com/articles/transferring-a-repository-owned-by-your-personal-account/#transferring-to-an-organization

Solution: if you transfer that repository to my account I will then transfer it into the organization and make sure you're added as an collaborator.

o0Ignition0o commented 6 years ago

Transfer ownership

This repository is being transferred to @badboy.

SGTM :D

badboy commented 6 years ago

The repository is now available in the rust-community orga: https://github.com/rust-community/rust-lang-blog-boilerplate

The community team members, content team members as well as @o0Ignition0o especially do have write access to it.