> This morning I wanted to install sage on another machine so I went to the > sage > installation guide <http://www.sagemath.org/doc/installation/index.html> > to remind myself where to clone the git repository from. As far as I can > see, there's no mention of git anywhere in this guide. In particular, there > is a install from source code > <http://www.sagemath.org/doc/installation/source.html> section that I > thought ought to mention using git, but it doesn't. > > Next I went to sage's download-source > <http://www.sagemath.org/download-source.html> web page. It also doesn't > mention git. (In addition, under the heading of "Source", there is also an > annoying circular link, Download complete source code > <http://www.sagemath.org/download-source.html>, that reloads the page for > you. This ought to be removed.) > > Finally, I found the information that I wanted in the Git the Hard way > <http://www.sagemath.org/doc/developer/manual_git.html#section-git-checkout> > section of the developer guide. > > I think that we ought to: > > - mention how to use git in the installation guide > - mention how to use git on the down-source web page (and the circular > link should be removed). > > In both cases, it is probably enough to add links to the developers guide. >
This seems very reasonable. I think that the point in the installation guide is that one doesn't actually need git to compile Sage; presumably quite a few people only compile it and never do anything with it that requires git. But of course cross-links are very good; we need more of them TO the installation guide, in fact, as it is a very comprehensive but under-appreciated resource. > Are there any reasons not to do this? Assuming not I can hack the > installation guide but, presumably, whoever maintains the download will > have to take care of that. > > Andrew > > -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
