Antoine Lambert authored 2 years ago and Antoine Lambert committed 1 year ago

It was excluded a couple of years ago as no relevant Python code was
contained in that package but this is no longer the case.

Those URLs makes the ShortenLinkTransform sphinx post-transform from the
pydata theme raise an exception when it attempts to process them using
Python >= 3.11.4, see https://github.com/python/cpython/issues/103848.

So align with other service URLs containing brackets in that doc page
and remove their scheme.

Paul Wise authored 1 year ago and Jérémy Bobbio (Lunar) committed 1 year ago

Asked-in: https://archive.softwareheritage.org/admin/add-forge/request/200/

Sadly there is a bug in the parsing of quotes in the `console` lexer.
So revert to `shell` which works fine and remove the prompt.

Also replace some tabs by spaces.

Co-Authored-By: Benoit Chauvet <contact@benoitchauvet.com>
Fixes: swh/devel/swh-docs#4745

This allows the generated snippet (by pygnents) to better handle the
selection for copy/pasting. Namely, the prompt will not be selected
which is what is expected for this kind of example snip.

- adapt command line examples to match current state od the swh-docker
  repository,
- add details about node label assignments,
- give details about replication factors for replayer services.

To generate the svg out of the mermaid source code:
```
$ docker run --rm -u `id -u`:`id -g` -v $(pwd):/data \
  minlag/mermaid-cli -i alertmanager-irc-relay.mmd
```

Refs. swh/infra/sysadm-environment#4525

This is not only used by the scheduler, and referencing the full range
of upstream settings may be useful.

Related to swh/infra/sysadm-environment#4824

Related to swh/infra/sysadm-environment#5024

Related to swh/infra/sysadm-environment#4998

Related to swh/infra/sysadm-environment#4824

Related to swh/infra/sysadm-environment#4824

Related to swh/infra/sysadm-environment#4824

Related to swh/meta#5043.

So CLI documentation can link to it instead of repeating the whole
configuration of each block.

This document Software Heritage policy regarding how takedown notices
must be handled on mirrors. Currently we are missing tooling to
implement it in full, but we can still document the stopgap process
and what we are aiming.

Thanks to ardumont and vlorentz for proofreading and spotting several
typos, syntax and grammar issues.

Ref swh/meta#4975

Refs. swh-lister#4693

vlorentz authored 1 year ago and vlorentz committed 1 year ago

They turn out to have their own usefulness, in addition to the unified
'Software Origin' list:
swh/devel/swh-docs!355 (comment 137637)

vlorentz authored 1 year ago and vlorentz committed 1 year ago

This reverts commit ae901af0.

Two people within the team reported it's hard to read for them
with the new theme (color-blindness)

Related to swh/devel/swh-web#4746

Logos in the table listing the forges were taking too much space,
resulting in unfortunate line breaks in other columns. Let’s reduce
their width to a minimum instead.

Also remove the secondary sidebar to get some extra space.

Properly specify that generate_forge_list.py is used as an input when
generating the lister and loader tables. We also change how the script
is invoked to be sure to use the current version.