[[TOC]]
{{{#!comment
= 🚨 BROADCAST 🚨 =

For maintenance, the **trac server will be switched off on Saturday** 10 / 09 / 2022 from 7:00 to 23:00 (Paris Time).

Sorry for the inconvenience, and thanks for your patience. Please go relax again.

The trac server is currently running in **slightly degraded mode**. Some advanced features are not yet working.
}}}
= Moving to Github! =

Sage development will soon move from Trac to Github! This was decided in a [https://groups.google.com/g/sage-devel/c/7h5JoRgHpxY vote on sage-devel] that closed on Oct 5, 2022. The migration work is coordinated in #30363.

= Welcome to the SageMath Development Organization Page =

[https://www.sagemath.org SageMath] is free and open software that supports  research and teaching in algebra, geometry, number theory, cryptography, etc.  Both the !SageMath development model and the technology in !SageMath itself are  distinguished by an extremely strong emphasis on openness, community,  cooperation, and collaboration: we are building the car, not reinventing the wheel.
View our [[https://github.com/sagemath/sage/blob/develop/CODE_OF_CONDUCT.md|Code of Conduct]].

The Sage Trac server (this web page) manages '''tickets''', the equivalents of Issues and Pull Requests (PRs).  In addition to bug reports, also ideas for features to add to !SageMath are appropriate as tickets. 

== Getting started ==

To create tickets, add comments on tickets, and edit wiki pages on this site, you need either a !GitHub account or a legacy sage-trac account.

'''Users with !GitHub accounts''' should use the [[https://trac.sagemath.org/github/login|GitHub Login]] link. (If you do not have an account on !GitHub yet, choose a user name and
[[https://github.com|create a GitHub account]].)

'''Users with legacy sage-trac accounts''' (account names not starting with "gh-") should use the [[https://trac.sagemath.org/login|Login]] link. Do ''not'' to use !GitHub login, as it will be treated as a separate user from their original account (unless you actively prefer to switch).

The [[TracGuide|Help/Guide]] link in the top right corner provides help with the Trac server.

== Reporting a bug ==

Please help !SageMath development by [[https://doc.sagemath.org/html/en/developer/trac.html#reporting-bugs|reporting bugs that you encounter]], no matter how trivial.
If you need to open a ticket, please use the `{{{` and `}}}` tags to add code snippets and !SageMath session transcripts. For example:

||= Markup =||= Displays as =||
||\
{{{#!td
{{{
{{{
sage: 1 + 2
3
}}}
}}}
}}}
{{{#!td
{{{
sage: 1 + 2
3
}}}
}}}
You can also use backticks ({{{`}}}) to demarcate inline code snippets, etc. This is useful around names like `DiGraph` to avoid an automatic wikilink (DiGraph), like so: {{{`DiGraph`}}}.

!SageMath makes use of many upstream projects, which have their own bug tracking pages. A selection: [https://github.com/cython/cython Cython], [https://github.com/linbox-team/fflas-ffpack/issues fflas-ffpack], [https://github.com/gap-system/gap/issues GAP], [https://gcc.gnu.org/bugzilla/ GCC] ([https://gcc.gnu.org/bugs/ instructions]), [https://github.com/linbox-team/givaro/issues Givaro], [https://sourceforge.net/p/jmol/bugs/ JMol], [https://github.com/linbox-team/linbox/issues LinBox], [https://sourceforge.net/p/maxima/bugs/ Maxima], [https://github.com/numpy/numpy/issues Numpy], [https://pari.math.u-bordeaux.fr/Bugs/ PARI/GP] ([https://pari.math.u-bordeaux.fr/Bugs/Reporting.html instructions]), [https://bugs.python.org/ Python], [https://www.singular.uni-kl.de:8002/trac/ Singular].

== Following the pulse of development ==

Follow the [[https://trac.sagemath.org/timeline|Trac development timeline]] or [[https://trac.sagemath.org/report/92|active tickets by time]], or view [[wiki:TicketReports|other ticket reports]].

Help by reviewing [[https://trac.sagemath.org/report/75|Tickets needing review]] (see  [[https://doc.sagemath.org/html/en/developer/reviewer_checklist.html|checklist]]).

Catch up on [[https://trac.sagemath.org/report/51|Open tickets you've participated in]] or make a [[http://trac.sagemath.org/sage_trac/query|Custom query]].

Contribute to the [[https://wiki.sagemath.org/ReleaseTours|Release notes for the current development series]] by collaborative editing.

Explore the [[https://trac.sagemath.org/report/95|Open meta-tickets on larger tasks]] or topical pages on [wiki:algebra Algebra], [wiki:SageCodingRoadMap Coding Theory], [wiki:SageCombinatRoadMap Combinatorics], [[https://trac.sagemath.org/ticket/30525|Manifolds]], [[https://trac.sagemath.org/ticket/20302|Optimization]], [wiki:SagePolyhedralGeometry Polyhedral Geometry], [wiki:symbolics Symbolics].

Discuss in [[https://groups.google.com/g/sage-devel|sage-devel]] or one of [[https://www.sagemath.org/development-groups.html|our other development groups]].

== Contributing by working on tickets ==

Our [[https://doc.sagemath.org/html/en/faq/faq-contribute.html|FAQ on contributing to SageMath]] will take you to sections [[https://doc.sagemath.org/html/en/developer/trac.html#working-on-tickets|Working on tickets]] and [[https://doc.sagemath.org/html/en/developer/manual_git.html|Working with git]] in the [https://www.sagemath.org/doc/developer/ Developer's Guide].
Make sure you understand the review process, and the procedures for opening and closing tickets. 

When opening a ticket to make a feature request or to plan a project, you may find our [[https://wiki.sagemath.org/feature_request_guidelines|Feature request guidelines]] helpful.

[[Image(ticket_badges.png, 547px)]]

After pushing a branch to a ticket, the ticket will show badges linking to results of automated tests that run on the [[patchbot]] and other [[https://trac.sagemath.org/wiki/ReleaseTours/sage-9.6#Newdevelopertools|tests that run on GitHub Actions]].

== Surveying the mathematical software landscape ==

The !SageMath project is a major integrating force in the math software landscape. Follow the ticket numbers to see how you can help; for example, by surveying software, building or extending interfaces, or contributing to distribution packaging.

||                                    ||= '''In the !SageMath distribution'''         =||= Not in the !SageMath distribution =||
||=Unused math software              =|| [[https://doc.sagemath.org/html/en/reference/spkg/symengine.html|SymEngine]], [[https://doc.sagemath.org/html/en/reference/spkg/cocoalib.html|cocoalib]], [[https://doc.sagemath.org/html/en/reference/spkg/isl.html|isl]], [[https://doc.sagemath.org/html/en/reference/spkg/cylp.html|CyLP]], ... #33773                 || [[https://www.sagemath.org/links.html|sagemath.org links]], [[https://wiki.sagemath.org/OSCAS|Open-source CAS]], [[https://wiki.sagemath.org/devel/SoftwareToIntegrate|SoftwareToIntegrate]], [[https://wiki.sagemath.org/devel/SoftwareSurveys|SoftwareSurveys]] #33725, [[https://trac.sagemath.org/ticket/26511|Python optimization packages]] #26511, [[https://wiki.sagemath.org/OptiPolyGeom|polyhedral geometry packages]], [[https://swmath.org/|swMATH.org]], math databases #30914
||=[[Upstream]] non-Python math software =||[[https://doc.sagemath.org/html/en/reference/spkg/|Packages]]: [[https://doc.sagemath.org/html/en/reference/spkg/gmp.html|GMP]], [[https://doc.sagemath.org/html/en/reference/spkg/flint.html|FLINT]] #31408, [[https://doc.sagemath.org/html/en/reference/spkg/arb.html|arb]], [[https://doc.sagemath.org/html/en/reference/spkg/singular.html|Singular]], [[https://doc.sagemath.org/html/en/reference/spkg/gap.html|GAP]], [[https://doc.sagemath.org/html/en/reference/spkg/pari.html|PARI]], [[https://doc.sagemath.org/html/en/reference/spkg/maxima.html|Maxima]], [[https://doc.sagemath.org/html/en/reference/spkg/r.html|R]], [[https://doc.sagemath.org/html/en/reference/spkg/fplll.html|FPLLL]], [[https://doc.sagemath.org/html/en/reference/spkg/linbox.html|LinBox]], [[https://doc.sagemath.org/html/en/reference/spkg/gsl.html|GSL]],  [[https://doc.sagemath.org/html/en/reference/spkg/polymake.html|polymake]], ... || [[https://wiki.sagemath.org/Interfaces#Interfaces_to_other_software_in_SageMath|Free software that Sage interfaces to]]: Macaulay2, Octave, ...; [[https://wiki.sagemath.org/Interfaces#Interfaces_to_other_software_in_SageMath|Non-free software that Sage interfaces to]]: Magma, Maple, Mathematica, CPLEX, Gurobi, SCIP, ...
||=[[Upstream]] Python math software     =||[[https://doc.sagemath.org/html/en/reference/spkg/|Packages]]: [[https://doc.sagemath.org/html/en/reference/spkg/numpy.html|NumPy]], [[https://doc.sagemath.org/html/en/reference/spkg/scipy.html|SciPy]], [[https://doc.sagemath.org/html/en/reference/spkg/sympy.html|SymPy]], [[https://doc.sagemath.org/html/en/reference/spkg/cvxopt.html|CVXOPT]], [[https://doc.sagemath.org/html/en/reference/spkg/networkx.html|NetworkX]], ...
||=[[Upstream]] distributions            =|| || [[https://wiki.sagemath.org/ReleaseTours/sage-9.1#Portability_improvements.2C_increased_use_of_system_packages|Distributions providing system packages]]: homebrew, conda-forge, archlinux, ... #27330
||= Absorbed libraries=|| [[https://trac.sagemath.org/ticket/32386|GiNaC/Pynac]] #33401, [[https://trac.sagemath.org/ticket/29171|giacpy]], [[https://trac.sagemath.org/ticket/30332|sage_brial]] ||    ||
||= '''[[https://doc.sagemath.org/html/en/reference/index.html|SageMath library]]'''=|| [[https://github.com/sagemath/sage/tree/develop/src/sage|Source]]: [[https://github.com/sagemath/sage/tree/develop/src/sage/algebras|sage.algebras.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/categories|sage.categories.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/combinat|sage.combinat.*]],  [[https://github.com/sagemath/sage/tree/develop/src/sage/crypto|sage.crypto.*]],  [[https://github.com/sagemath/sage/tree/develop/src/sage/geometry|sage.geometry.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/graphs|sage.graphs.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/groups|sage.groups.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/manifolds|sage.manifolds.*]],  [[https://github.com/sagemath/sage/tree/develop/src/sage/modular|sage.modular.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/rings|sage.rings.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/schemes|sage.schemes.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/symbolic|sage.symbolic.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/tensor|sage.tensor.*]], [[https://github.com/sagemath/sage/tree/develop/src/sage/topology|sage.topology.*]], ...
||= Absorbed !SageMath extensions=|| [[https://wiki.sagemath.org/combinat|Sage-Combinat]], [[https://sagemanifolds.obspm.fr/|SageManifolds]] || ||
||=Downstream software               =|| [[https://doc.sagemath.org/html/en/reference/spkg/sagetex|SageTeX]], [[https://trac.sagemath.org/ticket/31164|In-distribution Sage user packages]]: [[https://doc.sagemath.org/html/en/reference/spkg/admcycles|admcycles]], [[https://doc.sagemath.org/html/en/reference/spkg/sage_flatsurf|sage-flatsurf]], ...     || [[https://wiki.sagemath.org/SageMathExternalPackages|External Sage user packages]] #31164, [[https://wiki.sagemath.org/Interfaces#Interfaces_to_SageMath_in_other_software|GAP-homalg]]
||=User interfaces                   =|| Jupyter, !JupyterLab #30399            || [[https://wiki.sagemath.org/Emacs|Emacs sage-shell-mode]], [[https://wiki.sagemath.org/Interfaces#Interfaces_to_SageMath_in_other_software|Interfaces]], [[https://trac.sagemath.org/ticket/30500|IDEs]] #30500
||=Downstream distributions          =|| !SageMath distribution #33774, [[https://trac.sagemath.org/wiki/Distribution#Dockerimages|Sage Docker images]], modularized distributions on PyPI #29705, wheels #31251  || [[Distribution#Packagemanagers|Distributions carrying SageMath]]: conda-forge, archlinux, debian/ubuntu, fedora, [[https://github.com/cschwan/sage-on-gentoo|sage-on-gentoo]], nix, voidlinux, ... #33775; [[https://trac.sagemath.org/wiki/Distribution#Dockerimages|Third-party Docker images]]
||=Downstream deployments            =|| [[https://trac.sagemath.org/wiki/ReleaseTours/sage-9.6#SagedevelopmentinthecloudwithGitpod|Gitpod]] #33113 || [[https://doc.sagemath.org/html/en/installation/|Running SageMath in the cloud]]: [[https://cocalc.com/?utm_source=trac.sagemath.org|CoCalc]], [[https://sagecell.sagemath.org/|SageCell]], [[https://github.com/sagemath/sage-binder-env|Binder]]
||=Downstream of downstream          =|| Devcontainers #33671, #34363

This table is being moved to the Sage developer's guide in #34526; do not edit.

== Maintaining the social and technical infrastructure ==

Participate in or help organize [[https://wiki.sagemath.org/|Workshops and other activities]], or [[https://wiki.sagemath.org/contribute/AnswerQuestions|contribute to the Sage community by answering questions]].

You can also help maintain the [wiki:Infrastructure Technical project infrastructure].

== Additional formatting hints ==

You can enable syntax highlighting in these code snippets by using a hashbang (`#!`) followed by the name of the syntax. This also makes inline diff viewers if you choose the syntax name `diff`.
||= Markup =||= Displays as =||
||\
{{{#!td
{{{
{{{
#!python
def spam ():
    eggs = 3
    return 1
pine_for_fjords()
}}}
}}}
}}}
{{{#!td
{{{
#!python
def spam ():
    eggs = 3
    return 1
pine_for_fjords()
}}}
}}}
||
||\
{{{#!td
{{{
{{{
#!diff
foo

diff --git a/bar b/bar
--- a/bar
+++ b/bar
@@ -1,2 +1,3 @@
 baz
 quux
+xyzzy
}}}
}}}
}}}
{{{#!td
{{{
#!diff
foo

diff --git a/bar b/bar
--- a/bar
+++ b/bar
@@ -1,2 +1,3 @@
 baz
 quux
+xyzzy
}}}
}}}
To avoid an automatic wikilink for non-code names like !GitHub, prepend it with an exclamation mark: `!GitHub`. See WikiFormatting for more information.

== Account Names Mapped to Real Names ==

The list of over 600 account holders in Sage's Trac that was here is now merged to the  [[https://github.com/sagemath/website/blob/master/conf/contributors.xml|contributors.xml]] through [[https://github.com/sagemath/website/pull/311|Github PR]]. The merged developers list is at [[https://www.sagemath.org/development-map.html|SageMath developer world map]]. 

== Legacy sage-trac Account Request == #legacy-account-request

If you cannot create a !GitHub account, need to edit the !SageMath Wiki, or have other special needs, you may request a local account on this site, by reading the [https://www.sagemath.org/doc/developer/trac.html trac guidelines], then sending an email to sage-trac-account AT googlegroups DOT com that contains '''all''' of the following:

 * your full name
 * the default username is the first letter of the name followed by the family name (i.e. mjohnson for Mike Johnson). If you really want something else you can make a reasonable suggestion [https://trac.sagemath.org/#AccountNamesMappedtoRealNames some examples]
 * contact email
 * and reason for needing a trac account.