#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 jdemeyer):
Replying to [comment:16 kcrisman]:
> {{{
> #!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.
On the other hand, too much text and superfluous references can also be
confusing.
> The system requirements is not the same as actually installing them, and
for many Mac users this is really foreign territory.
In the guide, the sections "System-specific requirements" and "Installing
prerequisites" are very close together, so a user clicking on "System-
specific requirements" will see the "Installing prerequisites" section
also. Moreover, "System-specific requirements" even has an explicit link
for Mac OS X in the first sentence.
So I don't see what the problem could be with my changes.
--
Ticket URL: <http://trac.sagemath.org/ticket/17255#comment:17>
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.
