Skip to content

Commit ab99016

Browse files
committed
Merge pull request #96 from schacon/introduction
Add Front Matter
2 parents 6ac535c + 0fae623 commit ab99016

File tree

4 files changed

+175
-2
lines changed

4 files changed

+175
-2
lines changed

atlas.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
"book/cover.html",
55
"LICENSE.asc",
66
"book/preface.asc",
7+
"book/contributors.asc",
8+
"book/introduction.asc",
79
"book/toc.asc",
810
"book/01-introduction/1-introduction.asc",
911
"book/02-git-basics/1-git-basics.asc",
@@ -68,4 +70,4 @@
6870
},
6971
"theme": "oreillymedia/atlas_tech1c_theme",
7072
"title": "Pro Git"
71-
}
73+
}

book/contributors.asc

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
[preface]
2+
== Contributors
3+
4+
Since this is an Open Source book, we have gotten several errata and content changes donated over the years. Here are all the people who have contributed to the English version of Pro Git as an open source project. Thank you everyone for helping make this a better book for everyone.
5+
6+
[source]
7+
----
8+
2 Aaron Schumacher
9+
4 Aggelos Orfanakos
10+
4 Alec Clews
11+
1 Alex Moundalexis
12+
2 Alexander Harkness
13+
1 Alexander Kahn
14+
1 Andrew McCarthy
15+
1 AntonioK
16+
1 Benjamin Bergman
17+
1 Brennon Bortz
18+
2 Brian P O'Rourke
19+
1 Bryan Goines
20+
1 Cameron Wright
21+
1 Chris Down
22+
1 Christian Kluge
23+
1 Christoph Korn
24+
2 Ciro Santilli
25+
2 Cor
26+
1 Dan Croak
27+
1 Dan Johnson
28+
1 Daniel Kay
29+
2 Daniel Rosen
30+
1 DanielWeber
31+
1 Dave Dash
32+
10 Davide Fiorentino lo Regio
33+
2 Dilip M
34+
1 Dimitar Bonev
35+
1 Emmanuel Trillaud
36+
1 Eric-Paul Lecluse
37+
1 Eugene Serkin
38+
1 Fernando Dobladez
39+
2 Gordon McCreight
40+
1 Helmut K. C. Tessarek
41+
31 Igor Murzov
42+
1 Ilya Kuznetsov
43+
1 Jason St. John
44+
1 Jay Taggart
45+
1 Jean Jordaan
46+
51 Jean-Noël Avila
47+
1 Jean-Noël Rouvignac
48+
1 Jed Hartman
49+
1 Jeffrey Forman
50+
1 John DeStefano
51+
1 Junior
52+
1 Kieran Spear
53+
1 Larry Shatzer, Jr
54+
1 Linquize
55+
1 Markus
56+
7 Matt Deacalion Stevens
57+
1 Matthew McCullough
58+
1 Matthieu Moy
59+
1 Max F. Albrecht
60+
1 Michael Schneider
61+
8 Mike D. Smith
62+
1 Mike Limansky
63+
1 Olivier Trichet
64+
1 Ondrej Novy
65+
6 Ori Avtalion
66+
1 Paul Baumgart
67+
1 Peter Vojtek
68+
1 Philipp Kempgen
69+
2 Philippe Lhoste
70+
1 PowerKiKi
71+
1 Radek Simko
72+
1 Rasmus Abrahamsen
73+
1 Reinhard Holler
74+
1 Ross Light
75+
1 Ryuichi Okumura
76+
1 Sebastian Wiesinger
77+
1 Severyn Kozak
78+
1 Shane
79+
2 Shannen
80+
8 Sitaram Chamarty
81+
5 Soon Van
82+
4 Sven Axelsson
83+
2 Tim Court
84+
1 Tuomas Suutari
85+
1 Vlad Gorodetsky
86+
3 W. Trevor King
87+
1 Wyatt Carss
88+
1 Włodzimierz Gajda
89+
1 Xue Fuqiao
90+
1 Yue Lin Ho
91+
2 adelcambre
92+
1 anaran
93+
1 bdukes
94+
1 burningTyger
95+
1 cor
96+
1 iosias
97+
7 nicesw123
98+
1 onovy
99+
2 pcasaretto
100+
1 sampablokuper
101+
----
102+

book/introduction.asc

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
[preface]
2+
== Introduction
3+
4+
You’re about to spend several hours of your life reading about Git. Let’s take a minute to explain
5+
what we have in store for you. Here is a quick summary of the ten chapters and three appendices of this book.
6+
7+
In *Chapter 1*, we’re going to cover Version Control Systems (VCSs) and Git basics—no
8+
technical stuff, just what Git is, why it came about in a land full of VCSs, what sets it apart, and
9+
why so many people are using it. Then, we’ll explain how to download Git and set it up for the
10+
first time if you don’t already have it on your system.
11+
12+
In *Chapter 2*, we will go over basic Git usage—how to use Git in the 80% of cases you’ll
13+
encounter most often. After reading this chapter, you should be able to clone a repository, see
14+
what has happened in the history of the project, modify files, and contribute changes. If the book
15+
spontaneously combusts at this point, you should already be pretty useful wielding Git in the time
16+
it takes you to go pick up another copy.
17+
18+
*Chapter 3* is about the branching model in Git, often described as Git’s killer feature. Here
19+
you’ll learn what truly sets Git apart from the pack. When you’re done, you may feel the need to
20+
spend a quiet moment pondering how you lived before Git branching was part of your life.
21+
22+
*Chapter 4* will cover Git on the server. This chapter is for those of you who want to set up Git
23+
inside your organization or on your own personal server for collaboration. We will also explore
24+
various hosted options if you prefer to let someone else handle that for you.
25+
26+
*Chapter 5* will go over in full detail various distributed workflows and how to accomplish
27+
them with Git. When you are done with this chapter, you should be able to work expertly with
28+
multiple remote repositories, use Git over e-mail and deftly juggle numerous remote branches
29+
and contributed patches.
30+
31+
*Chapter 6* covers the GitHub hosting service and tooling in depth. We cover signing up for and managing an account, creating and using Git repositories, common workflows to contribute to projects and to accept contributions to yours, GitHub's programmatic interface and lots of little tips to make your life easier in general.
32+
33+
*Chapter 7* is about advanced Git commands. Here you will learn about topics like mastering the scary 'reset' command, using binary
34+
search to identify bugs, editing history, revision selection in detail, and a lot more. This
35+
chapter will round out your knowledge of Git so that you are truly a master.
36+
37+
*Chapter 8* is about configuring your custom Git environment. This includes setting up hook
38+
scripts to enforce or encourage customized policies and using environment configuration settings
39+
so you can work the way you want to. We will also cover building your own set of scripts to
40+
enforce a custom committing policy.
41+
42+
*Chapter 9* deals with Git and other VCSs. This includes using Git in a Subversion (SVN) world
43+
and converting projects from other VCSs to Git. A lot of organizations still use SVN and are
44+
not about to change, but by this point you’ll have learned the incredible power of Git—and this
45+
chapter shows you how to cope if you still have to use a SVN server. We also cover how to
46+
import projects from several different systems in case you do convince everyone to make the
47+
plunge.
48+
49+
Now that you know all about Git and can wield it with power and grace, you can move on to
50+
*Chapter 10*, which delves into the murky yet beautiful depths of Git internals. Here we will
51+
discuss how Git stores its objects, what the object model is, details of packfiles, server protocols,
52+
and more. Throughout the book, we will refer to sections of this chapter in case you feel like
53+
diving deep at that point; but if you are like me and want to dive into the technical details, you
54+
may want to read Chapter 10 first. We leave that up to you.
55+
56+
In *Appendix A* we look at a number of examples of using Git in various specific environments. We cover
57+
a number of different GUIs and IDE programming enviornments that you may want to use Git in and what
58+
is available for you. If you're interested in an overview of using Git in your shell, in Visual Studio
59+
or Eclipse, take a look here.
60+
61+
In *Appendix B* we explore scripting and extending Git through tools like libgit2 and JGit. If you're
62+
interested in writing complex and fast custom tools and need low level Git access, this is where you can
63+
see what that landscape looks like.
64+
65+
Finally in *Appendix C* we go through all the major Git commands one at a time and review where in the book
66+
we covered them and what we did with them. If you want to know where in the book we used any specific Git
67+
command you can look that up here.
68+
69+
Let’s get started.

book/preface.asc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Pro Git
66
:toclevels: 2
77

88
[preface,au="Scott Chacon"]
9-
== Introduction
9+
== Preface
1010

1111
Welcome to the second edition of Pro Git.
1212
The first edition was published over four years ago now.

0 commit comments

Comments
 (0)