Re: Formatting of the wml in the repo

Paul Wise <[email protected]>
Newsgroups gmane.linux.debian.devel.www
Organization Debian
Message-ID <[email protected]>
On Thu, 2022-07-21 at 20:15 +0200, Andreas Rönnquist wrote:

> Could we have some kind of standard for the formatting for the wml
> source in the repository?

Something like Semantic Line Breaks or one sentence per line might be
useful to work towards when rewriting or replacing sections of text.

https://sembr.org/
http://rhodesmill.org/brandon/2012/one-sentence-per-line/

> It's WAY easier to notice a changed word (and exactly what word is
> changed) in a 80 character line, than in a 300 character line, and we
> could even have some kind of policy to make each link on a newline,
> which I would find nice and avoid some trouble.

A better diff tool is probably the way to go for situations where line
endings aren't the appropriate place to break comparisons.

There are a number of potential options for this, the best one is
probably docdiff or wdiff depending on your preferences and commit.

git diff --color-words
git difftool --tool=wdiff
git difftool --tool=docdiff ; xdg-open diff.html
git difftool --tool=meld

-- 
bye,
pabs

https://wiki.debian.org/PaulWise
signature.asc (application/pgp-signature, 833 B)
-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEYQsotVz8/kXqG1Y7MRa6Xp/6aaMFAmLaAkYACgkQMRa6Xp/6
aaNkxA/9FrBBpKRffxGg61J1bCB2wMxm74WxIglprFPnGj9GYPuOIbVJEvdJNwUi
uNAmb9WFonK0yFMgh2Aa6IIbNDQf4rja4EJelAspW+NorDM7TDOl+GockoDBO5Ox
un3FBeXorUpCGahWAE72AK2eIKpsnD0zMEeJMPe7IpISQTwIDBY6n/Yn8WJjxLe2
y33aZt0TRj4EIDPkK5HfnKR/NzWfL49K3ZxTVVKvf8s7rgej1IAtuZxL175H/wGk
ip0+SDTgzApFm/AE8TNmsNBZAKu0Mmb+AcvFrggr6bVxWSudRy8TtU9AWK9SiW0/
0jeXArzFhHsRsXQpcL4RArAYp5SswmGJ0xYTkgqmZ3aB5Vv376OayaqXZX+70cAV
RCjPsWqhYnsfoElwjg16PvcaZ+tXhRBP703KJOQ0AdmcACbq/ccppb90AnQxLD4o
WNoA5qxWIGFuQOIqutdwj6rGi3p31cl7sIz0m6FtLYKRIUEXMSn6HR21Jn2EnbOv
llFylJUTnqmSFNECxu4nTr7uXCQQDRtz4LDhwPee0KAu2e7RXlyoD9e26LoRM9bl
cuhSWv4SEBAFXQwlbCU4iCH9Ae14BbHAowrNQKkx26UN/LMGnTXbywcA4ZtwkIoR
KiMPTtNSQqM+1zyxuByTsGyALtid9mxkq+fv59VKFx/7W3VW0XI=
=VgwJ
-----END PGP SIGNATURE-----
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.