#16030: Use "git trac" in the developer guide
-------------------------------------+-------------------------------------
Reporter: vbraun | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-6.2
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: Volker Braun | Reviewers: Ralf Stephan
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/vbraun/use__git_trac__in_the_developer_guide|
e3259d054147227f2ead7541b3ba0625ab615634
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by leif):
Replying to [comment:30 kcrisman]:
> I just hate that someone is directed first to install something else in
order to even start thinking of developing Sage. :-(
And it's IMHO a bit weird to assume someone would start ''developing''
Sage without (ever?) having it installed...
Of course there are also binary dists, but at least the source code of the
Sage library is always included, and I think most users will have taken a
look at it before considering contributing, or will at least have seen it
in tracebacks ;-) or by having typed `foo??`.
Still, there should probably be a special section or a whole chapter for
"absolute beginners", starting e.g. with how to fix a typo in the
documentation, i.e., where to find the relevant file(s), how to edit them,
how to rebuild the docs (and also the Sage library, in case of
docstrings), then introducing what revision control systems are all about,
that Sage (now) uses `git`, and how Sage development is organized (trac --
not just a bugtracker, but used for ''all'' Sage development; "stable"
releases vs. "development" releases, how reviewing happens, the relevant
mailing lists...) -- and the latter mostly in prose, without terminal
screen dumps, and without mentioning dozens of commands and options
(whether with or without referencing other sections) in the first place.
(I don't mean this should be added ''on this ticket'', and IMHO we should
get what we have into Sage 6.2, since then presumably a lot more people
will give feedback such that we can further improve it.)
--
Ticket URL: <http://trac.sagemath.org/ticket/16030#comment:42>
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.
