git/git.github.io

Git Developer Pages (This is NOT the place to discuss Git issues. See: https://git-scm.com/community)

Git Developer Pages

• This is a website for information on Git development. If you stumbled into this by mistake, you may want:

  • Information on running Git and links to download the latest version from HERE
  • Wiki that has historically contained developer information from HERE

• These pages are intended to collect information useful to Git developers. This is also the web home of:

  • the Hacking Git page,
  • the Git Rev News newsletter,
  • the involvement of the Git project in mentoring programs like Outreachy and the GSoC (Google Summer of Code)

• These pages are intended to be edited collaboratively (i.e., it is an alternative to us having a wiki, but one that is edited entirely via Git pushes).

  You could also send your changes as patches by email to Christian Couder < [email protected] > / Kaartic Sivaraam < [email protected] > (and feel free to cc [email protected] if appropriate).

Development

If you wish to spin up the site locally, you could follow the steps below.

• Make sure you've got ruby2 with dev-packages installed
• sudo gem install bundler
• Clone this repo
• sudo apt-get install zlib1g-dev # [ ref ]
• bundle install
• bundle exec jekyll serve
• browse the site on http://localhost:4000

Based on https://help.github.com/articles/using-jekyll-with-pages/

See our Contributors 😄

git.github.io's Issues

rev_news: try out the new github pages feed thing

Ref https://github.com/blog/2053-easier-feeds-for-github-pages

This could make our RSS feed more usable. I haven't heard any complaints yet, but just in case someone wants to have a go at this..

Bus factors

A low bus factor is a bad thing.

Please provide a RSS feed

It would be great to get new editions of the Git Rev newsletter through my RSS reader.

Broken Links in Git Rev News

Introductory text of git.github.io/rev_news reads like so: """Git Rev News: Edition 15 (May 11th, 2016)
Welcome to the 15th edition of Git Rev News, a digest of all things Git. For our goals, the archives, the way we work, and how to contribute or to subscribe, see the Git Rev News page on git.github.io.

This edition covers what happened during the month of April 2016, especially at the Git Contributor Summit on April 4 2016 and at the Git Merge conference on April 5 2016."""

Among three links, two of them go non-existent pages ("Git Rev News", and "Git Rev News page").

Broken links all around

It seems at some point the Jekyll/GitHub Pages thingie broke our links. Basically everywhere where we link to something rev_news/rev_news.html, it breaks on GitHub, but not when running locally with Jekyll. I'm not sure if this is a configuration issue, or some limitation in GitHub pages, but it's too late in the evening for me to fiddle with it now. Will have a look another day.

Any comment about upcoming Git Rev News edition 15

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-15.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 @durdn @gitster

MailChimp

I sent edition 19 using MailChimp but I did not use the template that Nicola had saved.
I tried it but it looked like the result had lost some formatting.
So instead I just used a new template where I just copied the HTML from the web page (https://git.github.io/rev_news/2016/09/14/edition-19/).

The main problem is that the background was white instead of brown. But otherwise the formatting looked better.

It would be nice to find a better solution to have both a good background and proper formatting.

Git Rev News #5

Please open the new issue ;-)

Improve the top of the newsletter

I'd rather have just something shorter at the top of each edition that redirect to http://git.github.io/rev_news/rev_news.html more strongly for all the meta information. And in turn we could have more and better meta information, like a nicer signup, on http://git.github.io/rev_news/rev_news.html.

For example if I would rewrite edition 2, I would only write something like (without showing the links) at the top:

Git Rev News: Edition 2 (April 15, 2015), 10 years of Git & Git Merge 2015!

Welcome to the second edition of Git Rev News, a digest of all things Git.
For our goals, the archives, the way we work, how to contribute or to
subscribe see the Git Rev News page on http://git.github.io.

This special edition covers Git's 10th year of existence, as well as the Git
Merge conference held on April 8th & 9th in Paris, France. Git developers
and users alike came together to celebrate the anniversary, and to discuss
the current challenges of using and scaling Git.

Discussions

General

10 years of fun

...

Any comment about upcoming Git Rev News edition 19

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-19.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 @gitster

Add analytics (for Rev News)

Some statistics would be a nice motivation tool.

Show table of contents in each Rev News post

Since they are quite long..

Make it easier to read on mobile

Some obvious points:

• The menu dominates above the content
• The fonts are way too small to be readable

RSS feed for Git Rev News

It would be nice to have an RSS feed for Git Rev News.

Any comment about upcoming Git Rev News edition 4

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-4.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 @durdn

Any comment about upcoming Git Rev News edition 10

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-10.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 @durdn @gitster

Any comment about upcoming Git Rev News edition 6

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-6.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 @durdn @gitster

Any comment about upcoming Git Rev News edition 12

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-12.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 @durdn @gitster

Compile Error on Git 2.0.1 on Redhat 5.9 with Fix

When compiling Git 2.0.1 on RedHat 5.9 as a non-root user I get the following error:

BUILD ERROR

make prefix=/home/eldon/local all doc info
...
    CC zlib.o
    CC unix-socket.o
    CC thread-utils.o
    CC compat/strlcpy.o
    AR libgit.a
/bin/sh: gar: command not found
make: *** [libgit.a] Error 127

My fix was to make a symlink below:

SYMLINK

gar -> /usr/bin/ar

LINUX VERSION

> lsb_release -i -r
Distributor ID: RedHatEnterpriseClient
Release:        5.9

I think the fix is to allow the use of "ar" if "gar" does not exist. I don't know if this exists for every Redhat install but "gar" is not available in /usr/bin but "ar" (which does exist in Redhat) does.

> /usr/bin/ar --version
GNU ar 2.17.50.0.6-20.el5_8.3 20061020
Copyright 2005 Free Software Foundation, Inc.

Any comment about upcoming Git Rev News edition 17

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-17.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 @durdn @gitster

Have a look at Jekyll Now and Paper Now

@tfnico as discussed IRL a few days ago ;-) we could have a look at:

https://github.com/PeerJ/paper-now

and:

http://www.jekyllnow.com/

rev_news: developer spotlight

Thanks to @gitster for this idea.

We could highlight some Git contributor in each edition. Hopefully we can have the first already in ed. 2 (#29).

Some example questions:

• Who are you, and what do you do?
• What would you name your most important contribution to Git?
• What are you doing on the Git project these days, and why?
• If you could get a team of expert developers to work full time on something in Git for a full year, what would it be?
• If you could remove something from Git without worrying about backwards compatibility, what would it be?
• What is your favorite Git-related tool/library, outside of Git itself?

Comments on SoC-2016-Ideas.md

I think "git fetch --deepen" is in progress by Duy; am I mistaken?

rev_news: twitter

Some readers probably prefer "subscribing" by following on Twitter (atleast my podcast gathered a few hundred followers there). Who's for opening a @gitrevnews Twitter account? (as in: I'll do it unless there are objections)

cc @durdn @chriscool

Any comment about upcoming Git Rev News edition 18

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-18.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 @durdn @gitster

Any comment about upcoming Git Rev News edition 13

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-13.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 @durdn @gitster

RevNews #2: do not forget to remove "Support" if it stays empty

As this issue is an "special edition", it is perfectly OK if there were nothing noteworthy to report in the "Support" section, but if that will be the end result (we may not know yet), please remove the section heading before the empty section (this comment applies to any other sections, but I think everything other than "Support" has some contents already).

Any comment about upcoming Git Rev News edition 2

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

_posts/YYYY-MM-DD-edition-N.markdown vs rev_news/edition-N.md???

I know we have some workaround for the first edition's URL, but do we need to keep rev_news/edition-N.md for N > 1?

rev_news: improve outline again

As discussed in f37b404.

Any comment about upcoming Git Rev News edition 8

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-8.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 @durdn @gitster

Any comment about upcoming Git Rev News edition 14

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-14.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 @durdn @gitster

rev_news: Broken rendering in edition 5

It looks like there's something wrong with the markdown in edition 5. More than half the page is being rendered as raw text.

(Search for "creates a new branch" to find the start of the raw text).

Any comment about upcoming Git Rev News edition 11

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-11.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 @durdn @gitster

Have a stable URL that always points at the latest edition

I was updating the MaintNotes and wanted to advertise the rev-news, but I had to spell the current one like this:

There is a volunteer-run newsletter to serve our community
(http://git.github.io/rev_news/edition-1.html). If you want to help
its publication, please contact Christian and/or Thomas.

which is way suboptimal. By the time I send it the next time, edition-1 would be stale, and
http://git.github.io/rev_news/ will just give us a 404.

https on git.github.io

GitHub Pages now officially support https, and we can start using to https:// links everywhere. We should probably mass-update existing links to use https.

Likewise, there's now a config option we can flip to redirect http traffic to https automatically. I can't think of a good reason not to do this, unless there's somebody who really has an http implementation that can't do https. That seems far-fetched to me in 2016. So modulo any objections, I'll do that soon in a day or two.

/cc @git/web

Any comment about upcoming Git Rev News edition 5

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-5.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 @durdn @gitster

Any comment about upcoming Git Rev News edition 20

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-20.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 @gitster

Any comment about upcoming Git Rev News edition 7

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-7.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 @chriscool @durdn @gitster

Jekyll 3.0 related warning

I got the following warning after editing rn-12:

Subject: [git/git.github.io] Page build warning

The page build completed successfully, but returned the following warning:

You are currently using the 'redcarpet' Markdown engine, which will not be supported on GitHub Pages after May 1st. At that time, your site will use 'kramdown' for markdown rendering instead. To suppress this warning, remove the 'markdown' setting in your site's '_config.yml' file and confirm your site renders as expected. For more information, see https://help.github.com/articles/updating-your-markdown-processor-to-kramdown.

GitHub Pages was recently upgraded to Jekyll 3.0. It may help to confirm you're using the correct dependencies:

  https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0

For information on troubleshooting Jekyll see:

  https://help.github.com/articles/using-jekyll-with-pages#troubleshooting

If you have any questions you can contact us by replying to this email.

It looks like we should try removing the 'markdown' setting from the '_config.yml' file.

Mailing list for Rev News

It would be useful for people interested in this publication to be able to subscribe to it via email.

There was some interest shown on hacker news - https://news.ycombinator.com/item?id=9264924

At the very least, letting people know how they can get new issues when they are released is important, even better if they can sign up to a list while reading an issue.

Any comment about upcoming Git Rev News edition 1

The draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/draft/edition-1.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

Only show excerpts in Rev News archive page

Once we have multiple editions, the archive page will be too long.

Any comment about upcoming Git Rev News edition 16

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-16.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 @durdn @gitster

https://github.com/git/git.github.io

Any comment about upcoming Git Rev News edition 9

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-9.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 @durdn @gitster

Add signup form at the bottom

This was discussed in issue #59.

Any comment about upcoming Git Rev News edition 3

A currently mostly empty draft is there:

https://github.com/git/git.github.io/blob/master/rev_news/drafts/edition-3.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 @durdn

Git and file attributes

I have used git for a long time, I found that when I change file attributes as chmod 755 file, git will mark as modified,

It's wrong, because git should track modified time, not changed time, it does not change content of file,

I think we should change this behaviour.

Gmane bugs and outages

I spend a lot of time these days to try to overcome gmane bugs or outages.

This is a problem because until now we have been using mostly gmane links especially for links from article titles to the discussion thread.

The last problem I had yesterday with gmane is that the following thread is missing some messages:

http://thread.gmane.org/gmane.comp.version-control.git/281254/

For example it is missing this message:

http://article.gmane.org/gmane.comp.version-control.git/281323/

I would have liked to write an article about this thread, but I didn't want to use a link to a broken thread on gmane, so I eventually chose another thread to write about.