------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.
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>
------7SD44E5RKC5IH2GEX9ZANIN84QSNM2
Content-Type: text/html;
charset=utf-8
Content-Transfer-Encoding: quoted-printable
<html><head></head><body><div dir="auto">Hi Christian,<br><br>Improving docs is a very important thing, I appreciate your effort.<br><br>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.<br><br>Once again, improving the wiki is a great
thing to do. Please keep up the good work :)<br><br>Best,<br>Ananthu</div><br><br><div class="gmail_quote"><div dir="auto">On 19 March 2024 10:47:07 am UTC,
c.buhtz@posteo.jp wrote:</div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex;
border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<pre class="k9mail"><div dir="auto">Hello together,<br><br>I still struggle with the docs but also improving them.<br><br>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.<br><br>I think in the long run I will add setup information to <a href="
https://wiki.debian.org/Salsa">https://wiki.debian.
org/Salsa</a> and link to it from Python/GitPackaging wiki page.<br>Please see my Salsa related questions in the other thread.<br><br>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.<br><br>Best Regards,<br>Christian Buhtz<br><br>[1] -- <<a href="
https://wiki.debian.org/Python/GitPackaging#Policies">https://wiki.debian.org/Python/GitPackaging#Policies</a>><br>[2] -- <<a href="
https://
github.com/moinwiki/moin/issues/1648">
https://github.com/moinwiki/moin/issues/1648</a>><br><br></div></pre></blockquote></div></body></html>
------7SD44E5RKC5IH2GEX9ZANIN84QSNM2--
--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)