#11081: Update the "Install from Source Code" section of the Sage Installation
Guide
-----------------------------------+----------------------------------------
Reporter: drkirkby | Owner: mvngu
Type: enhancement | Status: needs_review
Priority: blocker | Milestone: sage-4.7
Component: documentation | Keywords:
Author: David Kirkby | Upstream: N/A
Reviewer: Karl-Dieter Crisman | Merged:
Work_issues: |
-----------------------------------+----------------------------------------
Comment(by drkirkby):
Replying to [comment:14 jdemeyer]:
> Replying to [comment:8 drkirkby]:
> > I think one useful addition to the bottom of a page might be
> >
> > ''"Last updated on x/y/z"''
>
> Personally, I dislike non-automatic "last updated" lines like this one.
Do you know a relieable automated way?
> People will forget to update the "last updated" line when making changes
to the file.
Well, hopefully either the author or reviewer would notice.
The worst that can happen if someone forgets to update the line (and the
reviewer does not notice), is that users will think the information is
more outdated than it really is.
> Also, I don't see much usefulness in such a line.
Users can determine if the information is current, which is quite
important with information like this. It can tend to go out of date. If
users see the information was written a year or more ago, they might
realise its probably inaccurate.
> It would be really good to have this in sage-4.7.
I'm glad you think it would be useful. I'm surprised you updated it to
blocker (though I'm not complaining, but I'd like to see 'prerequisite
checks #11070 / #9978 in more!) But more seriously, we really need to stop
such an important part of the documentation getting so out of date.
Clearly many people will build Sage from source, yet so much of the
information was inaccurate.
If you feel strongly about it, I'll remove the "last update" bit.
Dave
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11081#comment:15>
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
