>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #93946. --> Reported by: [dww](https://www.drupal.org/user/46549) >>> <p>webchick, hunmonk and i just finished fleshing out a fairly comprehensive reorganization of the CVS-related sections of the handbook. this is critical for deploying the new release system ( ) since that makes such heavy use of CVS, and i desperately want our CVS-docs to be in top-shape for a whole new round of "RTFM!" i'm about to be shouting regularly. ;)</p> <p>the guiding principles of this re-org were:</p> <ol> <li>there are 3 audiences for this book: a) drupal.org CVS account holders, b) people trying to use CVS to help w/ testing, contribute patches, etc, but who don't have d.o cvs accounts and c) people trying to use CVS to deploy drupal code for real websites. </li><li>remove duplication of info </li><li>have everything flow nicely and make sense </li></ol> <p>there's a fancy editable copy of this outline here: <a href="http://docs.google.com/View?docID=dd27wbzs_0hcztvc">http://docs.google.com/View?docID=dd27wbzs_0hcztvc</a></p> <p>however, just so all the work we just spent isn't lost (and in case anyone else happens to care to comment) i'm pasting the current (mostly fixed) draft of the outline here:</p> <ul> <li>CVS <ul> <li>Introduction (these sub-bullets will just be parts of a single page, not subpages): <ul> <li>Link to good CVS overview tutorial (<a href="http://ximbiot.com/cvs/cvshome/docs/blandy.html">http://ximbiot.com/cvs/cvshome/docs/blandy.html</a>)</li> <li>Terms and how they apply to Drupal (dww - re-write of <a href="http://drupal.org/node/20219">http://drupal.org/node/20219</a>)</li> </ul> </li> <li>Recommended CVS clients <ul> <li>Eclipse (all platforms)</li> <li>SmartCVS (all platforms)</li> <li>TortoiseCVS (Windows)</li> <li>...</li> </ul> </li> <li>Drupal Repositories <ul> <li>Main (<a href="http://drupal.org/node/320">http://drupal.org/node/320</a>)</li> <li>Contributions (<a href="http://drupal.org/node/321">http://drupal.org/node/321</a>) <ul> <li>Layout of contributions repository (modules, themes, translations, sandbox)</li> </ul> </li> </ul> </li> <li>How Drupal uses branches and tags <ul> <li>Core</li> <li>Contrib</li> </ul> </li> <li>CVS accounts on drupal.org <ul> <li>Applying for CVS account</li> <li>CVS best practices on drupal.org</li> <ul> <li>General guidelines for using contrib repo (<a href="http://drupal.org/node/84256">http://drupal.org/node/84256</a>)</li> <li>Commit messages - history and credit (<a href="http://drupal.org/node/52287">http://drupal.org/node/52287</a>)</li> <li>Sandbox maintenance rules (<a href="http://drupal.org/node/773">http://drupal.org/node/773</a>)</li> </ul> <li>Managing drupal.org project releases with CVS (these sub-bullets will just be parts of a single page, not subpages): <ul> <li>Official release tags</li> <li>Development snapshots</li> <li>Stable branches for a specific version of core</li> <li>Development branches</li> <li>Strategies for using HEAD effectively<br></li> </ul> </li> </ul> <ul> <li>Troubleshooting (FAQ for whatever we often encounter w/ d.o devels) <ul> <li>Resolving "sticky tag is not a branch" error (<a href="http://drupal.org/node/57516">http://drupal.org/node/57516</a>)</li> </ul> </li></ul> </li> <li>Using CVS to maintain a Drupal website <ul> <li>Why you might want to do this (new page -- e.g. as a test site to keep up with HEAD development, etc, etc)</li> <li>Setting up a local CVS repository for customizations to Drupal code (<a href="http://drupal.org/node/5123">http://drupal.org/node/5123</a>)</li> </ul> </li> <li>Other resources <ul> <li>Infratructure mailing list</li> <li>CVS Book: <a href="http://cvsbook.red-bean.com">http://cvsbook.red-bean.com</a></li> <li>CVS manual: <a href="http://ximbiot.com/cvs/manual/cvs-1.11.18/cvs_toc.html#SEC_Contents">http://ximbiot.com/cvs/manual/cvs-1.11.18/cvs_toc.html#SEC_Contents</a></li> </ul> </li> </ul> </li> </ul> <p>Orphaned ideas:</p> <ul> <li>Overview of becoming a Drupal contributor <ul> <li>Creating a sandbox (show them how to commit basic code)</li> </ul> </li> </ul> <p>wherever possible, we're going to (sometimes massively) edit existing pages instead of just making new ones, so that links from other places still point to something reasonable. since 95% of this cleanup doesn't refer explicitly to the new release system, we're just doing it all on the live drupal.org handbook, instead of messing with scratch.drupal.org and duplicating the work.</p>