You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by mark benedetto king <bk...@inquira.com> on 2002/09/10 23:04:19 UTC

[PATCH] additional FAQ: "I'm new to version control ..."

* www/project_faq.html
 
  Add entry for SCM newbies.  Right now, punt by pointing them to
  Brad Appleton's SCM-links page.


Index: www/project_faq.html
===================================================================
--- www/project_faq.html
+++ www/project_faq.html	Tue Sep 10 18:56:43 2002
@@ -28,6 +28,8 @@
     same revision number? I want each of my projects to have their
     own revision numbers.  </a></li>
 <li><a href="#release">When's the next release?</a></li>
+<li><a href="#links">I'm new to version control.  Can you recommend
+    any reading material?  </a></li>  
 <li><a href="#more-information">I have other questions.  Where can I
     get more information?</a></li>  
 <p>
@@ -249,6 +251,15 @@
 
 <![CDATA[-----------------------------------------------------------]]>
 
+<h3>I'm new to version control.  Can you recommend any <a name="links">
+reading material</a>?</h3>  
+
+<p>Brad Appleton maintains an extensive
+<a href="http://acme.bradapp.net/links/scm-links.html">set of
+software change management links</a>.
+
+<![CDATA[-----------------------------------------------------------]]>
+
 <h3>I have other questions.  Where can I get more<a
 name="more-information"> information?</a></h3>
 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: [PATCH] additional FAQ: "I'm new to version control ..."

Posted by Brad Appleton <br...@bradapp.net>.
On Tue, Sep 10, 2002 at 04:49:42PM -0700, Greg Stein wrote:
> On Tue, Sep 10, 2002 at 07:04:19PM -0400, mark benedetto king wrote:
> > * www/project_faq.html
> >  
> >   Add entry for SCM newbies.  Right now, punt by pointing them to
> >   Brad Appleton's SCM-links page.
> 
> Hmm. I'm not so sure about that. Right at the top, it notes that there are
> 262 links. An SCM newbie is going to become lost. Fast.

Several of the links are also stale. I need to update it. I'm in the process of making a major update that I hope to complete by the end of the year.

But I agree that the aforementioned links page may be a bit too much at once for a newbie. I think that http://acme.bradapp.net/ would be a better. It starts off with an intro to the project, a link to a webpage of SCM definitions, another link to a page of recommended readings, as well as a link to the links page above, plus links to various papers (including branching papers)

Still - its a temporary solution at best. the CM yellow pages at CMtoday.com, or cmcrossroads.com, or ucmcentral.com is a more "hardcore" CM site (more than just version control). 

> Maybe there is a primer in there which could be used instead?

The closest thinig would be the "Streamed Lines" paper. Which is a bit of a primer (and then some) on branching.

> And hey... he doesn't even mention Subversion on that page! (gasp)

True (or CVS for that matter :)

If this is just a temporary solution for now, until there is more svn tutorial info available, then I'd recommend pointing to the main acme page for the time being (if you point to anything of mine that is :). Actually, the stuff in the upcoming book is the most appropriate, but if I make it fully available on the net my publisher will be unhappy with me :)

-- 
Brad Appleton <br...@bradapp.net>  http://www.bradapp.net/
 "Education is the ability to listen to almost anything
  without losing your temper or your self-confidence."
   -- Robert Frost

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: [PATCH] additional FAQ: "I'm new to version control ..."

Posted by Greg Stein <gs...@lyra.org>.
On Tue, Sep 10, 2002 at 07:04:19PM -0400, mark benedetto king wrote:
> * www/project_faq.html
>  
>   Add entry for SCM newbies.  Right now, punt by pointing them to
>   Brad Appleton's SCM-links page.

Hmm. I'm not so sure about that. Right at the top, it notes that there are
262 links. An SCM newbie is going to become lost. Fast.

Maybe there is a primer in there which could be used instead?

And hey... he doesn't even mention Subversion on that page! (gasp)

Cheers,
-g

-- 
Greg Stein, http://www.lyra.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org