From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id AA7D92441; Sun, 12 Jul 2026 15:08:43 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id 793882423; Sun, 12 Jul 2026 15:08:40 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=0.4 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DMARC_MISSING,FROM_SUSPICIOUS_NTLD,SPF_HELO_NONE, T_PDS_OTHER_BAD_TLD autolearn=no autolearn_force=no version=4.0.1 Received: from mail-108-mta94.mxroute.com (mail-108-mta94.mxroute.com [136.175.108.94]) by atuin.qyliss.net (Postfix) with ESMTPS id 6BDC723CC for ; Sun, 12 Jul 2026 15:08:38 +0000 (UTC) Received: from filter006.mxroute.com ([136.175.111.3] filter006.mxroute.com) (Authenticated sender: mN4UYu2MZsgR) by mail-108-mta94.mxroute.com (ZoneMTA) with ESMTPSA id 19f56df7d8700067f7.001 for (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Sun, 12 Jul 2026 15:08:35 +0000 X-Zone-Loop: 91a973bfd7bd921358e4fcba8eee1a323b304060a7c3 X-Originating-IP: [136.175.111.3] DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gagarin.work; s=x; h=Content-Transfer-Encoding:Content-Type:MIME-Version: References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=9n8OEIzuRN5CtN+lHPyty5IrhpCfCixfOhhneTadTAQ=; b=DOFhqXRk4I1seQCMlxYLacex8V uk1NpoiWT1KamUR1BO88fq6PBMpET822OTl0FIQgMvJu1bgvqk+Kk8VehQugBSuWfisi/m+JU2d1o Ps2orJhrWFktIp95P7RwBVgLb/gdjeBWJlx6hNxqFmIOW6OEz3p/AOGlHsZTKLeyfZ+fSSOEg/37D 19SJB3DSkgRvESJNX/9ZrVGpZsNOxakI/ElKgQDcDWRz3B3NQyEf55Ew7rG9tsdiqdF+Qj1vwopAo /UWb9/bLdh085OQL8ohz2XRBD/6F/xRkEyi8EAjwgcsIuKhYwOPQleLcYVx7QkOqp2HI3cflKthSG CsgqJRaw==; From: Valentin Gagarin To: devel@spectrum-os.org Subject: [PATCH v2] Documentation: remove redundant contributing page Date: Sun, 12 Jul 2026 17:08:17 +0200 Message-ID: <20260712150818.33640-1-valentin@gagarin.work> In-Reply-To: <20260707085833.161089-1-valentin@gagarin.work> References: <20260707085833.161089-1-valentin@gagarin.work> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Authenticated-Id: valentin@gagarin.work Message-ID-Hash: ORXKRWRXYVT7IQOX63WO5RAKIVNGUS6K X-Message-ID-Hash: ORXKRWRXYVT7IQOX63WO5RAKIVNGUS6K X-MailFrom: valentin@gagarin.work X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; header-match-devel.spectrum-os.org-3; header-match-devel.spectrum-os.org-4; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Valentin Gagarin X-Mailman-Version: 3.3.10 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Also point first readers to the contributing page, not the page with communication channels. This adds a Jekyll plugin for annotating redirects, such that links never have to break when source files are moved. In addition to creating placeholders in old locations containing the plugin produces a file `_site/redirects.json` with the format { "": "" } which can be fed to the webserver for generating server-side redirects. Signed-off-by: Valentin Gagarin --- Documentation/Gemfile | 2 + Documentation/Gemfile.lock | 3 + Documentation/README | 6 -- Documentation/_config.yml | 1 + Documentation/contributing.html | 91 ----------------------- Documentation/doc/contributing/index.adoc | 1 + Documentation/gemset.nix | 11 +++ Documentation/index.html | 5 +- 8 files changed, 21 insertions(+), 99 deletions(-) delete mode 100644 Documentation/contributing.html diff --git a/Documentation/Gemfile b/Documentation/Gemfile index a6396da..7de564a 100644 --- a/Documentation/Gemfile +++ b/Documentation/Gemfile @@ -6,3 +6,5 @@ source "https://rubygems.org" gem "jekyll" gem "jekyll-asciidoc" + +gem "jekyll-redirect-from" diff --git a/Documentation/Gemfile.lock b/Documentation/Gemfile.lock index 992e6da..03d4f60 100644 --- a/Documentation/Gemfile.lock +++ b/Documentation/Gemfile.lock @@ -43,6 +43,8 @@ GEM jekyll-asciidoc (3.0.1) asciidoctor (>= 1.5.0, < 3.0.0) jekyll (>= 3.0.0) + jekyll-redirect-from (0.16.0) + jekyll (>= 3.3, < 5.0) jekyll-sass-converter (3.1.0) sass-embedded (~> 1.75) jekyll-watch (2.2.1) @@ -81,6 +83,7 @@ PLATFORMS DEPENDENCIES jekyll jekyll-asciidoc + jekyll-redirect-from BUNDLED WITH 2.7.2 diff --git a/Documentation/README b/Documentation/README index bd02f12..f366637 100644 --- a/Documentation/README +++ b/Documentation/README @@ -1,12 +1,6 @@ These files contain the static portion of the website accessible at . Skit, Mailman, etc, are run separately. -If you would like to contribute to the Spectrum operating system itself, please -refer to the contributing.html file. - -If you'd like to contribute to the documentation, -see building-documentation.adoc for how to get started. - Design tweaks, content updates, fixes (both factual and grammatical), and new content for the Spectrum website are all welcomed. diff --git a/Documentation/_config.yml b/Documentation/_config.yml index cc3e8ea..a0623c4 100644 --- a/Documentation/_config.yml +++ b/Documentation/_config.yml @@ -4,6 +4,7 @@ title: Spectrum documentation plugins: - jekyll-asciidoc + - jekyll-redirect-from exclude: - '*.license' - '*.nix' diff --git a/Documentation/contributing.html b/Documentation/contributing.html deleted file mode 100644 index 9bb21d8..0000000 --- a/Documentation/contributing.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -layout: page -title: Contributing to Spectrum -nav_order: 10 ---- - - - - -

-Thank you so much for your interest in contributing to Spectrum. -Having a healthy community of people who feel empowered to work on the -project is vital to its success. To that end, if you have any -questions about contributing to the project, -please get in touch -with the community, and we'll gladly help you out! - -

Contributing code

- -

-If you're interested in contributing code to Spectrum, you -can find the source -repositories online. - -If you've made changes you'd like to be included in the official -Spectrum distribution, please send patches to the -spectrum-devel -mailing list -(devel@spectrum-os.org). - -

-DON'T PANIC. - -

-Sending patches to the list is easy — you can do it with Git, straight -from the command line. You don't have to set anything up in -your email client, and you don't have to subscribe to -the list. The only thing you need to do is probably to set -up Git so it knows how to send email using your provider's SMTP -server. These instructions -should be enough to get you going, but if you're still stuck, send an -email -to devel@spectrum-os.org -and we'll help you out. - -

-Once you have Git configured correctly, sending your changes to the -list should be as simple as something like - -

-git send-email origin/master --to devel@spectrum-os.org
-
- -

-You'll be CCed on replies to your posts, so you don't even have to be -subscribed to the mailing list if you're worried about too much -traffic. There's also -a web interface -that you can use to browse or even post to the mailing list. - -

-Please add a Signed-off-by line to each patch you submit, to indicate -your certification of -the Developer's -Certificate of Origin for that patch. The easiest way to do this -is with git commit's -s flag. - -

-Don't be too afraid of getting it wrong the first couple of times. -This might well be a new way of collaborating for you, and everybody -understands that. Hopefully, you'll soon realise just how effective -this style of collaboration can be compared to the alternatives. - -

Contributing other things

- -

-At this early stage, it's difficult to say what things would be useful -to the project beyond code. Artwork and documentation will be -extremely important and valuable, but we don't yet have a good place -to keep / use them. But, don't let that dissuade you! At some point -we'll need all sorts of things, and we might as well get the work done -early if people are willing to do it. - -

-If you think you have skills to offer the project beyond writing code, -we'd love to hear from you. The best thing to do is to either talk -with us -on spectrum-discuss, -or in real time -on Matrix or -IRC. diff --git a/Documentation/doc/contributing/index.adoc b/Documentation/doc/contributing/index.adoc index 04ff34a..c34f4c1 100644 --- a/Documentation/doc/contributing/index.adoc +++ b/Documentation/doc/contributing/index.adoc @@ -1,5 +1,6 @@ = Contributing :page-nav_order: 5 +:page-redirect_from: ["/contributing.html"] // SPDX-FileCopyrightText: 2023 Unikie // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0 diff --git a/Documentation/gemset.nix b/Documentation/gemset.nix index b31a35e..a28cf9f 100644 --- a/Documentation/gemset.nix +++ b/Documentation/gemset.nix @@ -165,6 +165,17 @@ }; version = "3.0.1"; }; + jekyll-redirect-from = { + dependencies = ["jekyll"]; + groups = ["default"]; + platforms = []; + source = { + remotes = ["https://rubygems.org"]; + sha256 = "1nz6kd6qsa160lmjmls4zgx7fwcpp8ac07mpzy80z6zgd7jwldb6"; + type = "gem"; + }; + version = "0.16.0"; + }; jekyll-sass-converter = { dependencies = ["sass-embedded"]; groups = ["default"]; diff --git a/Documentation/index.html b/Documentation/index.html index 5ce078c..6f7ff11 100644 --- a/Documentation/index.html +++ b/Documentation/index.html @@ -5,6 +5,7 @@ no_heading: true nav_order: 0 --- + @@ -47,7 +48,7 @@ desktop systems.

Spectrum is free software, currently under active development. If you are interested -in participating, +in contributing, we'd love to have you.

Funding

@@ -91,7 +92,7 @@ initiative by the Digital Single Market of the European Commission. and mailing lists
  • Git repositories
  • Documentation -
  • Contributing to Spectrum +
  • Contributing to Spectrum
  • Bugs and upcoming projects
  • Upstream bug/patch tracking -- 2.54.0