#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):
> > 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.
Yes, I thought about this a fair amount. Unfortunately one doesn't have a
focus group to test this on.
> > 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.
The problem isn't your change, it's the huge amount of text below it. But
I have come up with what I think will be a good compromise - one moment.
--
Ticket URL: <http://trac.sagemath.org/ticket/17255#comment:18>
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.
