Bug#567552: ITP: python-html2text -- A Python Script which converts HTML to Markdown
Stefano Rivera <firstname.lastname@example.org> writes:
> * Package name : python-html2text
Using the name ‘python-foo’ indicates that this is a package primarily
for use with Python. But the description you give strongly indicates
that is not the case: This is a program to be used from the command
line, and the user should not need to care that it's written in Python.
So I would suggest the name should not have the ‘python-’ prefix.
Since it converts the HTML to Markdown (and not to reStructuredText or
other text markup) would it be better named ‘html2mdwn’ or
‘html2markdown’? That makes it clearer what the package is for, and
doesn't imply that this is the *only* text markup format.
> Description : A Python Script which converts HTML to Markdown
Please follow the Best Packaging Practices for the package synopsis
It should be a simple noun phrase, not start with the article “A”, and
should not have implementation details like the programming language
(since as discussed above the user doesn't interact with it as a Python
I would suggest:
program for converting HTML to Markdown text
The implementation language (and many other details) can be communicated
by an appropriate debtag on the package, once it is in Debian.
\ 德不孤、必有鄰。 (The virtuous are not abandoned, |
`\ they shall surely have neighbours.) |
_o__) —孔夫子 Confucius, 551 BCE – 479 BCE |
Ben Finney <email@example.com>