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

sphinx-carousel is a Sphinx extension for creating slideshows using
Bootstrap carousels. The extension supports the PyData Sphinx theme that
we are currently using.

This would be a nice addition to show the various steps of an algorithm
in swh-alter documentation.

See: https://sphinx-carousel.readthedocs.io/ and
https://getbootstrap.com/docs/5.1/components/carousel/

Refs. swh/devel/swh-lister#4693

vlorentz authored 1 year ago and vlorentz committed 1 year ago

Logos were found anyway, somehow...

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)

and split line to make flake8 happy

Related to swh/devel/swh-web#4746

swh-webhooks package is detected as swh-web by the code of that function
but django is not installed when building standalone doc for this package.

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.

- use #E20026 as primary (SWH's red)
- use secondary color for main's page buttons
- use #52566D (light) / #DBDBDB (dark) secondary color

Refs. swh/infra/sysadm-environment#4825

The schedule-first-visits parameters was not exact

Refs. swh/infra/sysadm-environment#4813

Make clear that the “API reference” page is an index of our modules.
Add a pointer to the “interface” part of the landing page for people
wanting to learn how to interact with Software Heritage.

Closes #4740

To ease finding that page in the documentation. This transforms the chapter from the
onboarding mirror page to a link to that page.

So they can be reused more easily from the documentation.

Refs. swh/infra/sysadm-environment#4759

Some renaming were missing.

Refs. swh/infra/sysadm-environment#4794

As reference namespace is global, we need to make an extra effort to name
reference uniquely.

Without this step, services are not scheduled.

swh/infra/sysadm-environment#4794

This now also mentions the jenkins job to use to build docker image.

swh/infra/sysadm-environment#4794