#17255: Update developer and installation guide even more
-------------------------------------+-------------------------------------
Reporter: kcrisman | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-6.4
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: Karl-Dieter | Reviewers: John Palmieri, Jeroen
Crisman | Demeyer
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/jdemeyer/ticket/17255 | baaedc9ecf9592ae77795feb64ed3230e2ec8038
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by kcrisman):
> Are links between manuals possible? Just asking because of...
> which would ideally be an internal link.
Yes, I totally agree, but I felt like it was only possible within sections
of one manual, since each of them is built separately. (Otherwise, for
instance, we could link to localizations of documents.)
The fixes are all good (I only focused on new updates, didn't think to
update those things) except
{{{
#!diff
-This section details the technical prerequisites needed on any platform.
See
-`System-specific requirements`_ and `Installing prerequisites`_ for
details
-on how to acquire these. :ref:`Mac OS X <section_macprereqs>` has
-special instructions as developer tools do not come standard.
+This section details the technical prerequisites needed on all platforms.
See
+also the `System-specific requirements`_ below.
}}}
I purposely added all this originally because, in my experience with new
developers that truly have no developing experience (and I do have a
significant amount of experience with them), that little extra verbiage
and especially the two additional links will make a big difference. The
system requirements is not the same as actually installing them, and for
many Mac users this is really foreign territory. Even if you insist on
removing the Mac words, please do keep the installing prereqs link.
--
Ticket URL: <http://trac.sagemath.org/ticket/17255#comment:16>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
