RubyGems - wayfarer - Versions diffs - 0.4.8 → 0.4.10 - Mend

wayfarer 0.4.8 → 0.4.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (615) hide show

data/spec/support/static/git-scm.com/book/en/v2/Distributed-Git-Distributed-Workflows.html DELETED Viewed

@@ -1,859 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <!-- Global site tag (gtag.js) - Google Analytics -->
-  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-49925874-3"></script>
-  <script>
-    window.dataLayer = window.dataLayer || [];
-    function gtag(){dataLayer.push(arguments);}
-    gtag('js', new Date());
-    gtag('config', 'UA-49925874-3');
-  </script>
-  <meta charset='utf-8'>
-  <meta content='IE=edge,chrome=1' http-equiv='X-UA-Compatible'>
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Git - Distributed Workflows</title>
-  <link href='../../../favicon.ico' rel='shortcut icon' type='image/x-icon'>
-  <link rel="stylesheet" media="screen" href="../../../assets/application-cafcf280f67db0e6d8168ba98a38da878769a9d5f37793b68ffb963a02d185e0.css" />
-  <script src="../../../assets/modernize-b3ebe0c31c24f230dc62179d3e1030d2e57a53b1668d9382c0a27dbd44a94beb.js"></script>
-  <!--[if (gte IE 6)&(lte IE 8)]>
-  <script src="/javascripts/selectivizr-min.js"></script>
-  <![endif]-->
-</head>
-<body id="documentation">
-  <div class="inner">
-    <header>
-  <a href="https://git-scm.com/"><img src="../../../images/logo@2x.png" width="110" height="46" alt="Git" /></a>
-  <span id="tagline"></span>
-  <script type="text/javascript">
-    var taglines = ["fast-version-control","everything-is-local","distributed-even-if-your-workflow-isnt","local-branching-on-the-cheap","distributed-is-the-new-centralized"];
-    var tagline = taglines[Math.floor(Math.random() * taglines.length)];
-    document.getElementById('tagline').innerHTML = '--' + tagline;
-  </script>
-  <form id="search" action="https://git-scm.com/search/results">
-    <input id="search-text" name="search" placeholder="Search entire site..." autocomplete="off" type="text" />
-  </form>
-  <div id="search-results"></div>
-</header>
-  </div> <!-- .inner -->
-    <div class="inner">
-      <div id="content-wrapper">
-        <button class="sidebar-btn"></button>
-<aside class="sidebar" id="sidebar">
-  <nav>
-    <ul>
-      <li>
-        <a href="https://git-scm.com/about">About</a>
-        <ul class="">
-          <li>
-            <a href="https://git-scm.com/about">Branching and Merging</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/small-and-fast">Small and Fast</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/distributed">Distributed</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/info-assurance">Data Assurance</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/staging-area">Staging Area</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/free-and-open-source">Free and Open Source</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/about/trademark">Trademark</a>
-          </li>
-        </ul>
-      </li>
-      <li>
-        <a class="active" href="https://git-scm.com/doc">Documentation</a>
-        <ul class="expanded">
-          <li>
-            <a href="https://git-scm.com/docs">Reference</a>
-          </li>
-          <li>
-            <a class="active" href="https://git-scm.com/book">Book</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/videos">Videos</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/doc/ext">External Links</a>
-          </li>
-        </ul>
-      </li>
-      <li>
-        <a href="https://git-scm.com/downloads">Downloads</a>
-        <ul class="">
-          <li>
-            <a href="https://git-scm.com/downloads/guis">GUI Clients</a>
-          </li>
-          <li>
-            <a href="https://git-scm.com/downloads/logos">Logos</a>
-          </li>
-        </ul>
-      </li>
-      <li>
-        <a href="https://git-scm.com/community">Community</a>
-      </li>
-    </ul>
-      <hr class="sidebar">
-        <p>
-This book is available in
-  <a href="https://git-scm.com/book/en">English</a>.
-</p>
-<p>
-  Full translation available in
-  <table>
-    <tr><td><a href="https://git-scm.com/book/az">azərbaycan dili</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/bg">български език</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/de">Deutsch</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/es">Español</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/fr">Français</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/gr">Ελληνικά</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ja">日本語</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ko">한국어</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/nl">Nederlands</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ru">Русский</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/sl">Slovenščina</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/tl">Tagalog</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/uk">Українська</a></td></tr>
-    <tr><td><a href="https://git-scm.com/book/zh">简体中文</a>,</td></tr>
-  </table>
-</p>
-<p>
-  Partial translations available in
-  <table>
-    <tr><td><a href="https://git-scm.com/book/cs">Čeština</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/mk">Македонски</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/pl">Polski</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/sr">Српски</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/uz">Ўзбекча</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/zh-tw">繁體中文</a>,</td></tr>
-  </table>
-</p>
-<p>
-  Translations started for
-  <table>
-    <tr><td><a href="https://git-scm.com/book/be">Беларуская</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/fa" dir="rtl">فارسی</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/id">Indonesian</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/it">Italiano</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/ms">Bahasa Melayu</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/pt-br">Português (Brasil)</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/pt-pt">Português (Portugal)</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/sv">Svenska</a>,</td></tr>
-    <tr><td><a href="https://git-scm.com/book/tr">Türkçe</a>.</td></tr>
-  </table>
-</p>
-<hr class="sidebar"/>
-<p>
-The source of this book is <a href="https://github.com/progit/progit2">hosted on GitHub.</a></br>
-Patches, suggestions and comments are welcome.
-</p>
-  </nav>
-</aside>
-        <div id="content">
-<div id='book-chapters'>
-  <a class="dropdown-trigger" id="book-chapters-trigger" data-panel-id="chapters-dropdown" href="ch00/_integration_manager.html#">Chapters ▾</a>
-<div class='dropdown-panel' id='chapters-dropdown'>
-  <div class="three-column">
-    <div class='column-left'>
-      <ol class='book-toc'>
-  <li class='chapter'>
-  <h2>1. <a href="ch00/ch01-getting-started.html">Getting Started</a></h2>
-    <ol>
-        <li>
-          1.1
-          <a href="ch00/ch01-getting-started.html" >About Version Control </a>
-        </li>
-        <li>
-          1.2
-          <a href="Getting-Started-A-Short-History-of-Git.html" >A Short History of Git </a>
-        </li>
-        <li>
-          1.3
-          <a href="ch00/what_is_git_section.html" >What is Git? </a>
-        </li>
-        <li>
-          1.4
-          <a href="Getting-Started-The-Command-Line.html" >The Command Line </a>
-        </li>
-        <li>
-          1.5
-          <a href="Getting-Started-Installing-Git.html" >Installing Git </a>
-        </li>
-        <li>
-          1.6
-          <a href="ch00/_editor.html" >First-Time Git Setup </a>
-        </li>
-        <li>
-          1.7
-          <a href="ch00/_git_help.html" >Getting Help </a>
-        </li>
-        <li>
-          1.8
-          <a href="Getting-Started-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>2. <a href="ch00/_git_cloning.html">Git Basics</a></h2>
-    <ol>
-        <li>
-          2.1
-          <a href="ch00/_git_cloning.html" >Getting a Git Repository </a>
-        </li>
-        <li>
-          2.2
-          <a href="ch00/_git_mv.html" >Recording Changes to the Repository </a>
-        </li>
-        <li>
-          2.3
-          <a href="ch00/_viewing_history.html" >Viewing the Commit History </a>
-        </li>
-        <li>
-          2.4
-          <a href="ch00/_unstaging.html" >Undoing Things </a>
-        </li>
-        <li>
-          2.5
-          <a href="ch00/_remote_repos.html" >Working with Remotes </a>
-        </li>
-        <li>
-          2.6
-          <a href="ch00/_annotated_tags.html" >Tagging </a>
-        </li>
-        <li>
-          2.7
-          <a href="ch00/_git_aliases.html" >Git Aliases </a>
-        </li>
-        <li>
-          2.8
-          <a href="Git-Basics-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>3. <a href="ch00/_switching_branches.html">Git Branching</a></h2>
-    <ol>
-        <li>
-          3.1
-          <a href="ch00/_switching_branches.html" >Branches in a Nutshell </a>
-        </li>
-        <li>
-          3.2
-          <a href="ch00/_basic_branching.html" >Basic Branching and Merging </a>
-        </li>
-        <li>
-          3.3
-          <a href="ch00/_branch_management.html" >Branch Management </a>
-        </li>
-        <li>
-          3.4
-          <a href="ch00/_topic_branch.html" >Branching Workflows </a>
-        </li>
-        <li>
-          3.5
-          <a href="ch00/_delete_branches.html" >Remote Branches </a>
-        </li>
-        <li>
-          3.6
-          <a href="ch00/_rebase_rebase.html" >Rebasing </a>
-        </li>
-        <li>
-          3.7
-          <a href="Git-Branching-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>4. <a href="Git-on-the-Server-The-Protocols.html">Git on the Server</a></h2>
-    <ol>
-        <li>
-          4.1
-          <a href="Git-on-the-Server-The-Protocols.html" >The Protocols </a>
-        </li>
-        <li>
-          4.2
-          <a href="ch00/_bare_repo.html" >Getting Git on a Server </a>
-        </li>
-        <li>
-          4.3
-          <a href="ch00/_generate_ssh_key.html" >Generating Your SSH Public Key </a>
-        </li>
-        <li>
-          4.4
-          <a href="ch00/_setting_up_server.html" >Setting Up the Server </a>
-        </li>
-        <li>
-          4.5
-          <a href="Git-on-the-Server-Git-Daemon.html" >Git Daemon </a>
-        </li>
-        <li>
-          4.6
-          <a href="Git-on-the-Server-Smart-HTTP.html" >Smart HTTP </a>
-        </li>
-        <li>
-          4.7
-          <a href="Git-on-the-Server-GitWeb.html" >GitWeb </a>
-        </li>
-        <li>
-          4.8
-          <a href="ch00/_gitlab_groups_section.html" >GitLab </a>
-        </li>
-        <li>
-          4.9
-          <a href="Git-on-the-Server-Third-Party-Hosted-Options.html" >Third Party Hosted Options </a>
-        </li>
-        <li>
-          4.10
-          <a href="Git-on-the-Server-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>5. <a href="ch00/_integration_manager.html">Distributed Git</a></h2>
-    <ol>
-        <li>
-          5.1
-          <a href="ch00/_integration_manager.html" class=active>Distributed Workflows </a>
-        </li>
-        <li>
-          5.2
-          <a href="ch00/_project_over_email.html" >Contributing to a Project </a>
-        </li>
-        <li>
-          5.3
-          <a href="ch00/_git_am.html" >Maintaining a Project </a>
-        </li>
-        <li>
-          5.4
-          <a href="Distributed-Git-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-</ol>
-    </div>
-    <div class='column-middle'>
-      <ol class='book-toc'>
-  <li class='chapter'>
-  <h2>6. <a href="ch00/_personal_avatar.html">GitHub</a></h2>
-    <ol>
-        <li>
-          6.1
-          <a href="ch00/_personal_avatar.html" >Account Setup and Configuration </a>
-        </li>
-        <li>
-          6.2
-          <a href="ch00/_fetch_and_push_on_different_repositories.html" >Contributing to a Project </a>
-        </li>
-        <li>
-          6.3
-          <a href="ch00/_email_notifications.html" >Maintaining a Project </a>
-        </li>
-        <li>
-          6.4
-          <a href="ch00/_team_page.html" >Managing an organization </a>
-        </li>
-        <li>
-          6.5
-          <a href="ch00/_commit_status.html" >Scripting GitHub </a>
-        </li>
-        <li>
-          6.6
-          <a href="GitHub-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>7. <a href="ch00/_git_reflog.html">Git Tools</a></h2>
-    <ol>
-        <li>
-          7.1
-          <a href="ch00/_git_reflog.html" >Revision Selection </a>
-        </li>
-        <li>
-          7.2
-          <a href="ch00/_interactive_staging.html" >Interactive Staging </a>
-        </li>
-        <li>
-          7.3
-          <a href="ch00/_git_clean.html" >Stashing and Cleaning </a>
-        </li>
-        <li>
-          7.4
-          <a href="ch00/_signing_commits.html" >Signing Your Work </a>
-        </li>
-        <li>
-          7.5
-          <a href="ch00/_git_grep.html" >Searching </a>
-        </li>
-        <li>
-          7.6
-          <a href="ch00/_removing_file_every_commit.html" >Rewriting History </a>
-        </li>
-        <li>
-          7.7
-          <a href="ch00/_the_index.html" >Reset Demystified </a>
-        </li>
-        <li>
-          7.8
-          <a href="ch00/_reverse_commit.html" >Advanced Merging </a>
-        </li>
-        <li>
-          7.9
-          <a href="ch00/ref_rerere.html" >Rerere </a>
-        </li>
-        <li>
-          7.10
-          <a href="ch00/_file_annotation.html" >Debugging with Git </a>
-        </li>
-        <li>
-          7.11
-          <a href="ch00/_publishing_submodules.html" >Submodules </a>
-        </li>
-        <li>
-          7.12
-          <a href="ch00/_bundling.html" >Bundling </a>
-        </li>
-        <li>
-          7.13
-          <a href="ch00/_replace.html" >Replace </a>
-        </li>
-        <li>
-          7.14
-          <a href="ch00/_credential_caching.html" >Credential Storage </a>
-        </li>
-        <li>
-          7.15
-          <a href="Git-Tools-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>8. <a href="ch00/_external_merge_tools.html">Customizing Git</a></h2>
-    <ol>
-        <li>
-          8.1
-          <a href="ch00/_external_merge_tools.html" >Git Configuration </a>
-        </li>
-        <li>
-          8.2
-          <a href="ch00/_keyword_expansion.html" >Git Attributes </a>
-        </li>
-        <li>
-          8.3
-          <a href="ch00/_email_hooks.html" >Git Hooks </a>
-        </li>
-        <li>
-          8.4
-          <a href="ch00/_enforcing_commit_message_format.html" >An Example Git-Enforced Policy </a>
-        </li>
-        <li>
-          8.5
-          <a href="Customizing-Git-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>9. <a href="ch00/_git_svn.html">Git and Other Systems</a></h2>
-    <ol>
-        <li>
-          9.1
-          <a href="ch00/_git_svn.html" >Git as a Client </a>
-        </li>
-        <li>
-          9.2
-          <a href="ch00/_git_p4.html" >Migrating to Git </a>
-        </li>
-        <li>
-          9.3
-          <a href="Git-and-Other-Systems-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>10. <a href="ch00/_plumbing_porcelain.html">Git Internals</a></h2>
-    <ol>
-        <li>
-          10.1
-          <a href="ch00/_plumbing_porcelain.html" >Plumbing and Porcelain </a>
-        </li>
-        <li>
-          10.2
-          <a href="ch00/_git_commit_objects.html" >Git Objects </a>
-        </li>
-        <li>
-          10.3
-          <a href="ch00/ref_the_ref.html" >Git References </a>
-        </li>
-        <li>
-          10.4
-          <a href="Git-Internals-Packfiles.html" >Packfiles </a>
-        </li>
-        <li>
-          10.5
-          <a href="ch00/_pushing_refspecs.html" >The Refspec </a>
-        </li>
-        <li>
-          10.6
-          <a href="Git-Internals-Transfer-Protocols.html" >Transfer Protocols </a>
-        </li>
-        <li>
-          10.7
-          <a href="ch00/_git_gc.html" >Maintenance and Data Recovery </a>
-        </li>
-        <li>
-          10.8
-          <a href="Git-Internals-Environment-Variables.html" >Environment Variables </a>
-        </li>
-        <li>
-          10.9
-          <a href="Git-Internals-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-</ol>
-    </div>
-    <div class='column-right'>
-      <ol class='book-toc'>
-  <li class='chapter'>
-  <h2>A1. <a href="./Appendix-A:-Git-in-Other-Environments-Graphical-Interfaces.html">Appendix A: Git in Other Environments</a></h2>
-    <ol>
-        <li>
-          A1.1
-          <a href="./Appendix-A:-Git-in-Other-Environments-Graphical-Interfaces.html" >Graphical Interfaces </a>
-        </li>
-        <li>
-          A1.2
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Visual-Studio.html" >Git in Visual Studio </a>
-        </li>
-        <li>
-          A1.3
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Visual-Studio-Code.html" >Git in Visual Studio Code </a>
-        </li>
-        <li>
-          A1.4
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-IntelliJ-%252F-PyCharm-%252F-WebStorm-%252F-PhpStorm-%252F-RubyMine.html" >Git in IntelliJ / PyCharm / WebStorm / PhpStorm / RubyMine </a>
-        </li>
-        <li>
-          A1.5
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Sublime-Text.html" >Git in Sublime Text </a>
-        </li>
-        <li>
-          A1.6
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-Bash.html" >Git in Bash </a>
-        </li>
-        <li>
-          A1.7
-          <a href="ch00/oh_my_zsh_git.html" >Git in Zsh </a>
-        </li>
-        <li>
-          A1.8
-          <a href="./Appendix-A:-Git-in-Other-Environments-Git-in-PowerShell.html" >Git in PowerShell </a>
-        </li>
-        <li>
-          A1.9
-          <a href="./Appendix-A:-Git-in-Other-Environments-Summary.html" >Summary </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>A2. <a href="./Appendix-B:-Embedding-Git-in-your-Applications-Command-line-Git.html">Appendix B: Embedding Git in your Applications</a></h2>
-    <ol>
-        <li>
-          A2.1
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-Command-line-Git.html" >Command-line Git </a>
-        </li>
-        <li>
-          A2.2
-          <a href="ch00/_libgit2_bindings.html" >Libgit2 </a>
-        </li>
-        <li>
-          A2.3
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-JGit.html" >JGit </a>
-        </li>
-        <li>
-          A2.4
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-go-git.html" >go-git </a>
-        </li>
-        <li>
-          A2.5
-          <a href="./Appendix-B:-Embedding-Git-in-your-Applications-Dulwich.html" >Dulwich </a>
-        </li>
-    </ol>
-  </li>
-  <li class='chapter'>
-  <h2>A3. <a href="ch00/ch_core_editor.html">Appendix C: Git Commands</a></h2>
-    <ol>
-        <li>
-          A3.1
-          <a href="ch00/ch_core_editor.html" >Setup and Config </a>
-        </li>
-        <li>
-          A3.2
-          <a href="./Appendix-C:-Git-Commands-Getting-and-Creating-Projects.html" >Getting and Creating Projects </a>
-        </li>
-        <li>
-          A3.3
-          <a href="./Appendix-C:-Git-Commands-Basic-Snapshotting.html" >Basic Snapshotting </a>
-        </li>
-        <li>
-          A3.4
-          <a href="./Appendix-C:-Git-Commands-Branching-and-Merging.html" >Branching and Merging </a>
-        </li>
-        <li>
-          A3.5
-          <a href="./Appendix-C:-Git-Commands-Sharing-and-Updating-Projects.html" >Sharing and Updating Projects </a>
-        </li>
-        <li>
-          A3.6
-          <a href="./Appendix-C:-Git-Commands-Inspection-and-Comparison.html" >Inspection and Comparison </a>
-        </li>
-        <li>
-          A3.7
-          <a href="./Appendix-C:-Git-Commands-Debugging.html" >Debugging </a>
-        </li>
-        <li>
-          A3.8
-          <a href="./Appendix-C:-Git-Commands-Patching.html" >Patching </a>
-        </li>
-        <li>
-          A3.9
-          <a href="./Appendix-C:-Git-Commands-Email.html" >Email </a>
-        </li>
-        <li>
-          A3.10
-          <a href="./Appendix-C:-Git-Commands-External-Systems.html" >External Systems </a>
-        </li>
-        <li>
-          A3.11
-          <a href="./Appendix-C:-Git-Commands-Administration.html" >Administration </a>
-        </li>
-        <li>
-          A3.12
-          <a href="./Appendix-C:-Git-Commands-Plumbing-Commands.html" >Plumbing Commands </a>
-        </li>
-    </ol>
-  </li>
-</ol>
-    </div>
-  </div>
- </div>
-    <span class="light" id="edition">
-      2nd Edition
-    </span>
-</div>
-<div id='main' class="book edition2">
-    <h1>5.1 Distributed Git - Distributed Workflows</h1>
-  <div><p>
-Now that you have a remote Git repository set up as a focal point for all the developers to share their code, and you’re familiar with basic Git commands in a local workflow, you’ll look at how to utilize some of the distributed workflows that Git affords you.</p><p>In this chapter, you’ll see how to work with Git in a distributed environment as a contributor and an integrator.
-That is, you’ll learn how to contribute code successfully to a project and make it as easy on you and the project maintainer as possible, and also how to maintain a project successfully with a number of developers contributing.</p>
-<h2 id="_distributed_workflows">Distributed Workflows</h2>
-<div class="paragraph">
-<p>
-In contrast with Centralized Version Control Systems (CVCSs), the distributed nature of Git allows you to be far more flexible in how developers collaborate on projects.
-In centralized systems, every developer is a node working more or less equally with a central hub.
-In Git, however, every developer is potentially both a node and a hub; that is, every developer can both contribute code to other repositories and maintain a public repository on which others can base their work and which they can contribute to.
-This presents a vast range of workflow possibilities for your project and/or your team, so we’ll cover a few common paradigms that take advantage of this flexibility.
-We’ll go over the strengths and possible weaknesses of each design; you can choose a single one to use, or you can mix and match features from each.</p>
-</div>
-<div class="sect3">
-<h3 id="_centralized_workflow">Centralized Workflow</h3>
-<div class="paragraph">
-<p>
-In centralized systems, there is generally a single collaboration model — the centralized workflow.
-One central hub, or <em>repository</em>, can accept code, and everyone synchronizes their work with it.
-A number of developers are nodes — consumers of that hub — and synchronize with that centralized location.</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="images/centralized_workflow.png" alt="Centralized workflow">
-</div>
-<div class="title">Figure 53. Centralized workflow</div>
-</div>
-<div class="paragraph">
-<p>This means that if two developers clone from the hub and both make changes, the first developer to push their changes back up can do so with no problems.
-The second developer must merge in the first one’s work before pushing changes up, so as not to overwrite the first developer’s changes.
-This concept is as true in Git as it is in Subversion (or any CVCS), and this model works perfectly well in Git.</p>
-</div>
-<div class="paragraph">
-<p>If you are already comfortable with a centralized workflow in your company or team, you can easily continue using that workflow with Git.
-Simply set up a single repository, and give everyone on your team push access; Git won’t let users overwrite each other.</p>
-</div>
-<div class="paragraph">
-<p>Say John and Jessica both start working at the same time.
-John finishes his change and pushes it to the server.
-Then Jessica tries to push her changes, but the server rejects them.
-She is told that she’s trying to push non-fast-forward changes and that she won’t be able to do so until she fetches and merges.
-This workflow is attractive to a lot of people because it’s a paradigm that many are familiar and comfortable with.</p>
-</div>
-<div class="paragraph">
-<p>This is also not limited to small teams.
-With Git’s branching model, it’s possible for hundreds of developers to successfully work on a single project through dozens of branches simultaneously.</p>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_integration_manager">Integration-Manager Workflow</h3>
-<div class="paragraph">
-<p>
-Because Git allows you to have multiple remote repositories, it’s possible to have a workflow where each developer has write access to their own public repository and read access to everyone else’s.
-This scenario often includes a canonical repository that represents the “official” project.
-To contribute to that project, you create your own public clone of the project and push your changes to it.
-Then, you can send a request to the maintainer of the main project to pull in your changes.
-The maintainer can then add your repository as a remote, test your changes locally, merge them into their branch, and push back to their repository.
-The process works as follows (see <a href="ch00/wfdiag_b.html">Integration-manager workflow</a>):</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>The project maintainer pushes to their public repository.</p>
-</li>
-<li>
-<p>A contributor clones that repository and makes changes.</p>
-</li>
-<li>
-<p>The contributor pushes to their own public copy.</p>
-</li>
-<li>
-<p>The contributor sends the maintainer an email asking them to pull changes.</p>
-</li>
-<li>
-<p>The maintainer adds the contributor’s repository as a remote and merges locally.</p>
-</li>
-<li>
-<p>The maintainer pushes merged changes to the main repository.</p>
-</li>
-</ol>
-</div>
-<div id="wfdiag_b" class="imageblock">
-<div class="content">
-<img src="images/integration-manager.png" alt="Integration-manager workflow">
-</div>
-<div class="title">Figure 54. Integration-manager workflow</div>
-</div>
-<div class="paragraph">
-<p>
-This is a very common workflow with hub-based tools like GitHub or GitLab, where it’s easy to fork a project and push your changes into your fork for everyone to see.
-One of the main advantages of this approach is that you can continue to work, and the maintainer of the main repository can pull in your changes at any time.
-Contributors don’t have to wait for the project to incorporate their changes — each party can work at their own pace.</p>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_dictator_and_lieutenants_workflow">Dictator and Lieutenants Workflow</h3>
-<div class="paragraph">
-<p>
-This is a variant of a multiple-repository workflow.
-It’s generally used by huge projects with hundreds of collaborators; one famous example is the Linux kernel.
-Various integration managers are in charge of certain parts of the repository; they’re called <em>lieutenants</em>.
-All the lieutenants have one integration manager known as the benevolent dictator.
-The benevolent dictator pushes from their directory to a reference repository from which all the collaborators need to pull.
-The process works like this (see <a href="ch00/wfdiag_c.html">Benevolent dictator workflow</a>):</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Regular developers work on their topic branch and rebase their work on top of <code>master</code>.
-The <code>master</code> branch is that of the reference repository to which the dictator pushes.</p>
-</li>
-<li>
-<p>Lieutenants merge the developers' topic branches into their <code>master</code> branch.</p>
-</li>
-<li>
-<p>The dictator merges the lieutenants' <code>master</code> branches into the dictator’s <code>master</code> branch.</p>
-</li>
-<li>
-<p>Finally, the dictator pushes that <code>master</code> branch to the reference repository so the other developers can rebase on it.</p>
-</li>
-</ol>
-</div>
-<div id="wfdiag_c" class="imageblock">
-<div class="content">
-<img src="images/benevolent-dictator.png" alt="Benevolent dictator workflow">
-</div>
-<div class="title">Figure 55. Benevolent dictator workflow</div>
-</div>
-<div class="paragraph">
-<p>This kind of workflow isn’t common, but can be useful in very big projects, or in highly hierarchical environments.
-It allows the project leader (the dictator) to delegate much of the work and collect large subsets of code at multiple points before integrating them.</p>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_patterns_for_managing_source_code_branches">Patterns for Managing Source Code Branches</h3>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>Martin Fowler has made a guide "Patterns for Managing Source Code Branches".
-This guide covers all the common Git workflows, and explains how/when to use them.
-There’s also a section comparing high and low integration frequencies.</p>
-</div>
-<div class="paragraph">
-<p><a href="https://martinfowler.com/articles/branching-patterns.html" class="bare">https://martinfowler.com/articles/branching-patterns.html</a></p>
-</div>
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect3">
-<h3 id="_workflows_summary">Workflows Summary</h3>
-<div class="paragraph">
-<p>These are some commonly used workflows that are possible with a distributed system like Git, but you can see that many variations are possible to suit your particular real-world workflow.
-Now that you can (hopefully) determine which workflow combination may work for you, we’ll cover some more specific examples of how to accomplish the main roles that make up the different flows.
-In the next section, you’ll learn about a few common patterns for contributing to a project.</p>
-</div>
-</div>
-<div id="nav"><a href="Git-on-the-Server-Summary.html">prev</a> | <a href="ch00/_project_over_email.html">next</a></div></div>
-</div>
-        </div>
-      </div>
-      <footer>
-  <div class="site-source">
-    <a href="https://git-scm.com/site">About this site</a><br>
-    Patches, suggestions, and comments are welcome.
-  </div>
-  <div class="sfc-member">
-    Git is a member of <a href="https://git-scm.com/sfc">Software Freedom Conservancy</a>
-  </div>
-</footer>
-<a href="ch00/_integration_manager.html#top" class="no-js scrollToTop" id="scrollToTop" data-label="Scroll to top">
-  <img src="../../../images/icons/chevron-up@2x.png" width="20" height="20" alt="scroll-to-top"/>
-</a>
-<script src="../../../assets/application-38b0d42ff05ffea45841edebbd14b75b89585646153808e82907c2c5c11f324b.js"></script>
-    </div>
-</body>
-</html>