Path: csiph.com!fu-berlin.de!bofh.it!news.nic.it!robomod From: weepingclown Newsgroups: linux.debian.maint.python Subject: =?US-ASCII?Q?Re=3A_Wiki=3A_Setup_the_environment=2C_e=2Eg=2E_=22sals?= =?US-ASCII?Q?a=22_script_/_Request_to_review_modified_docs?= Date: Tue, 19 Mar 2024 12:50:01 +0100 Message-ID: References: X-Mailbox-Line: From debian-python-request@lists.debian.org Tue Mar 19 11:49:17 2024 Old-Return-Path: 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: archive/latest/21628 List-ID: List-URL: 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 ------7SD44E5RKC5IH2GEX9ZANIN84QSNM2 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi Christian, Improving docs is a very important thing, I appreciate your effort=2E 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=2E While gb= p pq is what the python team prefers indeed, the python team policy does no= t prevent quilt usage and instead mentions explicitly that optionally quilt= can be used=2E As such, I do not find mentioning "using quilt is not recom= mended" appropriate as it has the connotation "you should not use quilt"=2E= As someone who takes advantage of the policy leniency and find quilt easie= r than gbp pq, I thought this has to be mentioned=2E Once again, improving the wiki is a great thing to do=2E Please keep up th= e good work :) Best, Ananthu On 19 March 2024 10:47:07 am UTC, c=2Ebuhtz@posteo=2Ejp wrote: >Hello together, > >I still struggle with the docs but also improving them=2E > >First of all please review my modifications to make sure there are no mis= leading errors in the content=2E I restructured the "Policy" section [1]=2E= I shortened and rephrased the text=2E I also added a sub section "Setup an= d configure the system" with missing details=2E > >I think in the long run I will add setup information to https://wiki=2Ede= bian=2Eorg/Salsa and link to it from Python/GitPackaging wiki page=2E >Please see my Salsa related questions in the other thread=2E > >As a side note: There is an open discussion at MoinWiki to improve the ha= ndling of headings and page titles [2]=2E The later should not be part of t= he TOC=2E > >Best Regards, >Christian Buhtz > >[1] -- >[2] -- > ------7SD44E5RKC5IH2GEX9ZANIN84QSNM2 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable

Hi Christian,

Improving d= ocs is a very important thing, I appreciate your effort=2E

I quickly= went through thr diff off your changes and it seems that you've changed th= e wiki to mention that using quilt is not recommended=2E While gbp pq is wh= at the python team prefers indeed, the python team policy does not prevent = quilt usage and instead mentions explicitly that optionally quilt can be us= ed=2E As such, I do not find mentioning "using quilt is not recommended" ap= propriate as it has the connotation "you should not use quilt"=2E As someon= e who takes advantage of the policy leniency and find quilt easier than gbp= pq, I thought this has to be mentioned=2E

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

Best= ,
Ananthu

On 1= 9 March 2024 10:47:07 am UTC, c=2Ebuhtz@posteo=2Ejp wrote:

Hello together,

I still str=
uggle with the docs but also improving them=2E

First of all please r=
eview my modifications to make sure there are no misleading errors in the c=
ontent=2E I restructured the "Policy" section [1]=2E I shortened and rephra=
sed the text=2E I also added a sub section "Setup and configure the system"=
 with missing details=2E

I think in the long run I will add setup in=
formation to https://wiki=2Ed=
ebian=2Eorg/Salsa and link to it from Python/GitPackaging wiki page=2E<=
br>Please see my Salsa related questions in the other thread=2E

As a=
 side note: There is an open discussion at MoinWiki to improve the handling=
 of headings and page titles [2]=2E The later should not be part of the TOC=
=2E

Best Regards,
Christian Buhtz

[1] -- <https://wiki=2Edebi=
an=2Eorg/Python/GitPackaging#Policies>
[2] -- <https://github=2Ecom/moinwiki/m=
oin/issues/1648>

------7SD44E5RKC5IH2GEX9ZANIN84QSNM2--