[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#778269: ITP: python-mkdocs -- Static site generator geared towards building project documentation



Brian May <bam@debian.org> writes:

> On 14 February 2015 at 09:52, Brian May <bam@debian.org> wrote:
>
> > What should I call the package? mkdocs? Or python3-mkdocs?
>
> Thinking about this, I will call the source python-mkdocs, but the
> binary package just mkdocs.

+1.

For the user-facing application package, it's best that the package
name, package description etc. not even mention the implementation
language.

The implementation language is irrelevant distraction to someone
installing or using the tool for a non-programming purpose. It belongs
in debtags for the package.

This also allows for the package to be re-implemented in some other
language later without a weirdly ill-fitting name, or the disruption of
a naming change.

Choosing names for things is difficult to get right. Thanks for
considering it seriously.

-- 
 \     “Why doesn't Python warn that it's not 100% perfect? Are people |
  `\         just supposed to “know” this, magically?” —Mitya Sirenef, |
_o__)                                     comp.lang.python, 2012-12-27 |
Ben Finney <ben@benfinney.id.au>


Reply to: