Groups > linux.debian.maint.python > #15623

Re: Wiki: Setup the environment, e.g. "salsa" script / Request to review modified docs

Path	csiph.com!fu-berlin.de!bofh.it!news.nic.it!robomod
From	weepingclown <weepingclown@disroot.org>
Newsgroups	linux.debian.maint.python
Subject	Re: Wiki: Setup the environment, e.g. "salsa" script / Request to review modified docs
Date	Tue, 19 Mar 2024 12:50:01 +0100
Message-ID	<IjG8F-98X-1@gated-at.bofh.it> (permalink)
References	<IjFcC-8y4-11@gated-at.bofh.it>
X-Mailbox-Line	From debian-python-request@lists.debian.org Tue Mar 19 11:49:17 2024
Old-Return-Path	<weepingclown@disroot.org>
X-Amavis-Spam-Status	No, score=-5.21 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=2, LDO_WHITELIST=-5, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=no autolearn_force=no
X-Policyd-Weight	using cached result; rate: -4.6
MIME-Version	1.0
Content-Type	multipart/alternative; boundary=----7SD44E5RKC5IH2GEX9ZANIN84QSNM2
Content-Transfer-Encoding	7bit
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/21628
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/2B265781-83BE-46E4-97C5-48A7D340A237@disroot.org
Approved	robomod@news.nic.it
Lines	87
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Tue, 19 Mar 2024 11:48:47 +0000
X-Original-Message-ID	<2B265781-83BE-46E4-97C5-48A7D340A237@disroot.org>
X-Original-References	<3584302c4d15f62314914f040cb8820c@posteo.de>
Xref	csiph.com linux.debian.maint.python:15623

Show key headers only | View raw

[Multipart message — attachments visible in raw view] - view raw

Hi Christian,

Improving docs is a very important thing, I appreciate your effort.

I quickly went through thr diff off your changes and it seems that you've changed the wiki to mention that using quilt is not recommended. While gbp pq is what the python team prefers indeed, the python team policy does not prevent quilt usage and instead mentions explicitly that optionally quilt can be used. As such, I do not find mentioning "using quilt is not recommended" appropriate as it has the connotation "you should not use quilt". As someone who takes advantage of the policy leniency and find quilt easier than gbp pq, I thought this has to be mentioned.

Once again, improving the wiki is a great thing to do. Please keep up the good work :)

Best,
Ananthu

On 19 March 2024 10:47:07 am UTC, c.buhtz@posteo.jp wrote:
>Hello together,
>
>I still struggle with the docs but also improving them.
>
>First of all please review my modifications to make sure there are no misleading errors in the content. I restructured the "Policy" section [1]. I shortened and rephrased the text. I also added a sub section "Setup and configure the system" with missing details.
>
>I think in the long run I will add setup information to https://wiki.debian.org/Salsa and link to it from Python/GitPackaging wiki page.
>Please see my Salsa related questions in the other thread.
>
>As a side note: There is an open discussion at MoinWiki to improve the handling of headings and page titles [2]. The later should not be part of the TOC.
>
>Best Regards,
>Christian Buhtz
>
>[1] -- <https://wiki.debian.org/Python/GitPackaging#Policies>
>[2] -- <https://github.com/moinwiki/moin/issues/1648>
>

Thread

Wiki: Setup the environment, e.g. "salsa" script / Request to  review modified docs c.buhtz@posteo.jp - 2024-03-19 11:50 +0100
  Re: Wiki: Setup the environment, e.g. "salsa" script / Request to review modified docs weepingclown <weepingclown@disroot.org> - 2024-03-19 12:50 +0100
    Re: Wiki: Setup the environment, e.g. "salsa" script / Request to  review modified docs Andreas Tille <andreas@an3as.eu> - 2024-03-19 17:20 +0100
      Re: Wiki: Setup the environment, e.g. "salsa" script / Request to  review modified docs Brian May <bam@debian.org> - 2024-03-20 01:20 +0100
        Re: Wiki: Setup the environment, e.g. "salsa" script / Request to  review modified docs Andreas Tille <andreas@an3as.eu> - 2024-03-20 12:00 +0100
  Re: Wiki: Setup the environment, e.g. "salsa" script / Request to  review modified docs c.buhtz@posteo.jp - 2024-03-20 12:10 +0100
    Re: Wiki: Setup the environment, e.g. "salsa" script / Request to  review modified docs Andreas Tille <andreas@an3as.eu> - 2024-03-22 17:40 +0100

csiph-web