Improve distributing packages

[rffontenelle]

This PR apply the following changes in source/guides/distributing-packages-using-setuptools.rst:

• Make setup() arg names literal (e.g. name, version, description), so that translators know it should not be translated.
• Fix a paragraph that had full-stop character before an "and", and remove literal from placeholder pair that ought to be translated.

[webknjaz]

Looks like this one should probably be kept as inline code because it refers to the code snippet above.

[webknjaz]

I think, maybe we could instead mark this as translatable on Weblate? Even as inline code.

[rffontenelle]

Ok, I undo this change. I thought translating the inline code would make sphinx-build complain, but I tested it right now and it doesn't. Actually, when translating Python Docs (also reStructuredText) it is Transifex that complains. Therefore, this change is unnecessary.

I will undo this. I won't revert it thought, because in the same commit I fix a fullstop in this character.

[webknjaz]

Perfect, thanks!

P.S. Pro tip: you can add -n to the git revert command and it'll let you make some edits and choose what to commit. This way you can produce partial reverts :)

[webknjaz]

And I'd keep this as is too.

[webknjaz]

I like this except for those data files changes that seem incorrect.

[webknjaz]

• Fix a paragraph that had full-stop character before an "and", and remove literal from placeholder pair that ought to be translated.

@meowmeowmeowcat what are your thoughts on this? I think the translatability shouldn't depend on whether something is marked as inline code visually. I think I'd just apply the read-only flag to untranslatable things on Weblate, as you suggested earlier.

[rffontenelle]

I think the translatability shouldn't depend on whether something is marked as inline code visually.

Correct. As I mentioned in a reply above, I thought inline code should not be translated or sphinx-build would complain, and it is not true.

I think I'd just apply the read-only flag to untranslatable things on Weblate, as you suggested earlier.

@webknjaz This PR has 2 commits, and you quoted the description of the latter. When you mention 'read-only' flag, do you refer to the former commit (which has the setup() args)? I would be fine not putting in inline, and having it set as read-only. Actually setting as read only was my suggestion it in the comments in Weblate.

[dukecat0]

@meowmeowmeowcat what are your thoughts on this? I think the translatability shouldn't depend on whether something is marked as inline code visually. I think I'd just apply the read-only flag to untranslatable things on Weblate, as you suggested earlier.

@webknjaz I agree with you here. However, translators will think that inline code is untranslatable normally. Maybe we should give them some hints for translatable inline code? Like adding explanations to them.

[webknjaz]

Actually setting as read only was my suggestion it in the comments in Weblate.

Oh, my bad 🤦‍♂️, I keep confusing folks on the Internet :)

Like adding explanations to them.

That's a great idea! I like it.