#16048: dev docs: Inclusion Procedure for New and Updated Packages
-------------------------------------+-------------------------------------
Reporter: rws | Owner:
Type: defect | Status: needs_work
Priority: major | Milestone: sage-6.2
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: Ralf Stephan | Reviewers:
Report Upstream: N/A | Work issues:
Branch: public/spkg- | Commit:
devdoc-1 | 469f971e9bd04ddf19ad8e2e42afb0dea643d72d
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by vdelecroix):
Hi,
0) It would be nice to start with a section explaining how the
installation procedure works ("how does this work" or "the big picture")
and make appropriate pointers to the install scripts. Part of it is
already explained in "Directory structure".
1) There is a lot of intersection between your new section "Procedure for
..." and the "Prerequisites". It would make more sense to have only one.
2) About "Testing". Firstly there is a typo ``SAGE_ROOT/upstream/` should
be closed with two backquotes. Secondly, the name of the section is not
very appropriate as it intersects with "Self-test". It would also be
better if the content of this section appear inside "how this work"
mentioned in 0).
Vincent
--
Ticket URL: <http://trac.sagemath.org/ticket/16048#comment:11>
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.
