Unverified Commit bb416761 authored by anarcat's avatar anarcat
Browse files

Revert Trac documentation removal 

I feel the GitLab migration documentation belongs there, and could be
helpful to not pretend Trac never existed...

This reverts commit:

6a447183 remove link to dead trac page
1735010a remove trac documentation now that it is retired
parent 31591c37

howto/trac.md

0 → 100644
+53 −0
Original line number Diff line number Diff line 
Important note: Trac was migrated to [howto/GitLab](howto/GitLab) in June 2020. See

[howto/gitlab](howto/gitlab#Migration) for the details. This is kept only for historical

reference.



Commandline access

==================



We use [cartman](https://github.com/tamentis/cartman/), a "commandline trac client" which "allows you to

create and manage your Trac tickets from the command-line, without the

need to setup physical access to the Trac installation/database".



Install:



    virtualenv --python=python3 --system-site-packages ~/.virtualenvs/cartman

    ~/.virtualenvs/cartman/bin/pip install cartman

    alias cm=~/.virtualenvs/cartman/bin/cm



Config:



    [trac]

    base_url = https://trac.torproject.org/projects/tor

    username = anarcat

    password = ....

    auth_type = basic



The password can be ommitted and passed through the environment

instead with [this patch](https://github.com/tamentis/cartman/pull/30).



Template:



    To: anarcat

    Cc: 

    Milestone: 

    Component: Internal Services/Tor Sysadmin Team

    Priority: Medium

    Type: defect

    Keywords: 

    Version: 

    Subject: test



    test



Running:



    TRAC_PASSWORD=$(pass trac.torproject.org) cm new



Other documentation

===================



There's very little documentation on our Trac instance out there. This

page was originally created to quickly jot down notes on how to

batch-create tickets. There's also a [Trac page in the Tor Trac

wiki](https://gitlab.torproject.org/legacy/trac/-/wikis/org/operations/services/trac) and the [upstream documentation](https://trac.edgewall.org/).

service.md

+2 −1
Original line number Diff line number Diff line
@@ -206,9 +206,10 @@ Those services have been retired. 
| oniongit      | test GitLab instance          | <https://oniongit.eu>             | hiro                | Eventually migrated to GitLab |

| pipeline      | ?                             | <https://pipeline.torproject.org> | ?                   |                               |

| [Prodromus][] | Web chat for support team     | <https://support.torproject.org>  | phoul, lunar, helix | ?                             |

| Trac          | Issues, wiki                  | <https://trac.torproject.org>     | hiro                | Migrated to GitLab, archived  |

| [Trac][]      | Issues, wiki                  | <https://trac.torproject.org>     | hiro                | Migrated to GitLab, archived  |

| XMPP          | Chat/messaging                |                                   | dgoulet             | Abandoned for lack of users   |



[Trac]: howto/trac

[Prodromus]: https://github.com/rkallensee/prodromus

[Atlas]: https://atlas.torproject.org