doc:git

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
doc:git [2011/12/07 00:20] – Formatting frozenfiredoc:git [2011/12/07 00:42] – Formatting, added to Git Project Structure section frozenfire
Line 3: Line 3:
  
 === Current Project Structure === === Current Project Structure ===
 +The Subversion repository for the PHP Documentation project is currently stored in the
 +[[https://svn.php.net/viewvc/|main PHP repository]] under [[https://svn.php.net/viewvc/phpdoc/|phpdoc]].
 +It is divided into two main subsections, and a number of active and inactive translations.
  
 == Main Subsections == == Main Subsections ==
Line 8: Line 11:
   - [[https://svn.php.net/viewvc/phpdoc/modules/|Modules]]   - [[https://svn.php.net/viewvc/phpdoc/modules/|Modules]]
     * [[https://svn.php.net/viewvc/phpdoc/modules/doc-en/|Doc-En]]     * [[https://svn.php.net/viewvc/phpdoc/modules/doc-en/|Doc-En]]
-        svn:externals 
-        doc-base https://svn.php.net/repository/phpdoc/doc-base/trunk 
-        en https://svn.php.net/repository/phpdoc/en/trunk 
- 
     * //[[https://svn.php.net/viewvc/phpdoc/modules/|Others]]//     * //[[https://svn.php.net/viewvc/phpdoc/modules/|Others]]//
  
Line 28: Line 27:
   - //[[https://svn.php.net/viewvc/phpdoc/|Other Inactive]]//   - //[[https://svn.php.net/viewvc/phpdoc/|Other Inactive]]//
  
 +== Properties ==
 +Modules are achieved using the Subversion property known as svn:externals. This prop allows external
 +Subversion paths to be linked into the project by URL.
 +
 +''doc-en Module Example''
 +>doc-base https://svn.php.net/repository/phpdoc/doc-base/trunk
 +>en https://svn.php.net/repository/phpdoc/en/trunk
 +
 +=== Proposed Git Structure ===
 +Because of a few technical limitations of the Git version control system, some major structural changes
 +are required for the transition to Git from Subversion. First and foremost, Git does not support
 +partial check-outs of a subsection of the repository.
 +Because of this, the project much be split into several independent repositories, and "wrapper"
 +repositories whose function is to define a set of submodules that make up each translation's project.
 +
 +== Doc-Base ==
 +Since the doc-base path of the PHP Documentation project is a global dependency for all builds, it makes up its own major project, which all wrapper repositories will include as a submodule.
 +
 +== "Wrapper" Repositories ==
 +Each wrapper repository will include doc-base and its respective translation project as submodules.
doc/git.txt · Last modified: 2020/09/03 01:18 by avenger

Page Tools