Any comment about upcoming Git Rev News edition 2

[chriscool]

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/draft/edition-2.md

feel free to comment in this issue, or to use the edit button (that looks like a pen) to edit and create a pull request with the changes you would like.

Thanks!

cc @tfnico

[tfnico]

Thanks. Correct link is here: https://github.com/git/git.github.io/blob/master/rev_news/draft/edition-2.md

Any thoughts on a more blog-like publishing engine? The left menu on http://git.github.io/ doesn't really scale well.

Do we have a publishing date? By then, I'll go through the sources and collect all new interesting links.

[chriscool]

Yeah, sorry I updated my comment above to have the correct link.

I agree about the publishing engine and the left menu.
Also the current CSS doesn't show the quoted text very well. For example I prefer to read edition 1 here rather than on git.github.io.

My guess about the publishing date is that it might be nice to have a kind of special edition after the Git-Merge, so on the 13th of April. I hope you are coming to the Git-Merge?

[tfnico]

@chriscool I will be at Git-Merge indeed!

Regarding blog-engine, Jekyll is the one suggested at https://pages.github.com/

Should we still place the content under http://git.github.io/rev_news/ ? I'm hoping Jekyll does not depend on being under the root context. I am a bit clueless when it comes to these static blog-engines. I'll see if I can get around to play around with it a bit over the next weeks, but I still have another GitMinutes to ship before Git-Merge.. Perhaps someone could helps us out here.

What is the mechanism behind the current web-page on http://git.github.io/ ? @peff ?

[gitster]

The expected publishing date being later than GitMerge, do you still want "contact Peff to attend GitMerge"? Does he have a time machine?

[peff]

I think it is already formatted by Jekyll, but there are probably more "blog-like" ways to use it. Please feel free to do whatever you like to reformat the site, including replacing the left nav-bar with something more useful (or for that matter, updating the rather ugly CSS styles I threw in there). The initial look was always meant to be improved upon when somebody had the time and skill to give it more attention.

[chriscool]

@gitster yeah you are right I hadn't thought about the next publishing date when I created the mostly empty draft for edition 2.

@peff ok thanks hopefully we will have time to have a look at improving the look.

[tfnico]

@chriscool As far as I can understand, GitHub will to a degree just render Jekyll source code into HTML the way it does now. I'm afraid, but not sure in my case here, that this is a limited model for publishing. For example, vanilla Jekyll does not offer any RSS feed. You need to have a ruby gem render these, and I doubt GitHub offers that out of the box. Instead, we have to run the static page generation from some machine we control, and push the produced HTML and RSS/XML files manually (or in a continuous integration fashion).

There is also Octopress, which is Jekyll adapted into blog-mode, but they seem to be on the verge of making a new major release with lots of changes.

I'm not an avid Ruby-user, so this is all a bit foreign to me. Perhaps @schacon could advise?

[peff]

I think that GitHub Pages is full-blown Jekyll, and you should never have to render and push up static content yourself.

You should be able to use something like the RSS templates here. That iterates over site.posts, but we don't have anything in our _posts directory. I'm not sure if there is a way to mark rev_news/ as posts, or if the directory needs to be renamed (possibly just as _posts/rev_news. It also looks at other post-specific variables; it would probably make sense to define those in the YAML front-matter of each post.

You can also iterate over the pages, and possibly only match /rev_news or something. I don't really know what the limits of Jekyll are. My experience is mostly writing the trivial iteration that's in the left navbar.

[tfnico]

@peff thanks so much! I'll have a go at setting this up then. Someone
suggested that I use the Jekyll site itself as an example, and I think that
could be a good start for our own site.
On Mar 26, 2015 3:37 AM, "Jeff King" [email protected] wrote:

I think that GitHub Pages is full-blown Jekyll, and you should never have
to render and push up static content yourself.

You should be able to use something like the RSS templates here
https://github.com/snaptortoise/jekyll-rss-feeds. That iterates over
site.posts, but we don't have anything in our _posts directory. I'm not
sure if there is a way to mark rev_news/ as posts, or if the directory
needs to be renamed (possibly just as _posts/rev_news. It also looks at
other post-specific variables; it would probably make sense to define those
in the YAML front-matter of each post.

You can also iterate over the pages, and possibly only match /rev_news or
something. I don't really know what the limits of Jekyll are. My experience
is mostly writing the trivial iteration that's in the left navbar.

—
Reply to this email directly or view it on GitHub
#29 (comment).

[chriscool]

@peff anf @tfnico thanks a lot for looking at that!

[tfnico]

For the link section:

• History time. Linus first ever mention of what would become Git: https://news.ycombinator.com/item?id=9264088
• As Google Code shuts down, the Vim project decides moving to Git/GitHub: https://news.ycombinator.com/item?id=9263193

Edit to add more:

• Nice SVG-based Git cheat sheet: https://rawgit.com/pastjean/git-cheat-sheet/master/git-cheat-sheet.svg
• Mary Rose Cook's essay has been published here: http://maryrosecook.com/blog/post/git-from-the-inside-out
• A similar article from last year: https://jwiegley.github.io/git-from-the-bottom-up/
• Timely for Git-Merge in Paris: French Civil Code now on GitHub: https://news.ycombinator.com/item?id=9294954
• Øyvind A. Holm has generated statistics on the relative growth of Git repos vs the other VCS: https://github.com/sunny256/openhub-repositories
• A Git Style Guide by Agis Anastasopoulos: https://github.com/agis-/git-style-guide

After Git Merge 2015:

• Linus comments on 10 years of Git: http://www.linux.com/news/featured-blogs/185-jennifer-cloer/821541-10-years-of-git-an-interview-with-git-creator-linus-torvalds
• Hefty discussion about the new git lfs: https://news.ycombinator.com/item?id=9343021

[tfnico]

@chriscool let's decide a shipping date. Is Sunday evening OK? We can still save more articles from Git Merge to edition 3, if we don't get everything down until then.

[chriscool]

@tfnico I think we should announce a draft and a shipping date on the mailing list only when we have some content on the draft, so that people are encouraged to write a few articles. And we should give them a few days to do that.

But yeah I hope that we will have a few articles by Sunday evening so that we can announce a draft then and maybe release edition 2 on Wednesday.

[chriscool]

For the link section, linux.com published an interview of Linus about 10 years of Git:

http://www.linux.com/news/featured-blogs/185-jennifer-cloer/821541-10-years-of-git-an-interview-with-git-creator-linus-torvalds

and also some interesting "Git Success Stories and Tips from X" articles:

https://www.linux.com/news/featured-blogs

[tfnico]

@chriscool OK, I've massaged my links above into the draft now. Thanks for the tips!

[chriscool]

@tfnico great, thanks!
I have written 2 articles and will try to write another one tomorrow.

[chriscool]

@durdn do you want to write something about John Garcia's presentation? I think it would be nice if we could cover both big file related talks in this edition.

[durdn]

@chriscool good idea, let me see if I can cook something.

[chriscool]

@tfnico we should also probably add a link to:

https://www.atlassian.com/git/articles/10-years-of-git/

[tfnico]

Ok, I'm busy gardening today, but I'll do some more fixes tonight. Will
also sum up recent releases.

On Sun, Apr 12, 2015, 10:45 Christian Couder [email protected]
wrote:

@tfnico https://github.com/tfnico we should also probably add a link to:

https://www.atlassian.com/git/articles/10-years-of-git/

—
Reply to this email directly or view it on GitHub
#29 (comment).

[chriscool]

@tfnico ok thanks!
I will still send an email about the draft on the mailing list soon.

[chriscool]

@tfnico there is another git success story on linux.com

https://www.linux.com/news/featured-blogs/200-libby-clark/823164-git-success-stories-and-tips-from-ceph-creator-sage-weil

it looks like it is the last one.

[tfnico]

@chriscool thanks, added.

[chriscool]

Closing this as edition 2 is published now.