Re: [PATCH 00/32] Create an User's manual and improve development-process book

From: Mauro Carvalho Chehab
Date: Tue Oct 18 2016 - 06:20:35 EST


Em Tue, 18 Oct 2016 13:01:01 +0300
Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> escreveu:

> On Tue, 18 Oct 2016, Jonathan Corbet <corbet@xxxxxxx> wrote:
> > So I raised this topic in talks at both Kernel Recipes and LinuxCon
> > Europe, and nobody threw things at me. I have come to suspect that I'm
> > worrying a little too much about it; maybe we should go ahead and move
> > the documents and see who screams.
>
> While at it, how about unifying some of the FilenamesInCamelCase,
> filenames-with-hyphens, and filenames_with_underscores too...? To at
> least move things towards just one of them within one directory.

Sure, let's do it. I would just keep README as README.rst , as people
are more used to see readme files on upercases.

For the rest, what's your preference?

- FooBar.rst
- foo_bar.rst
- foo-bar.rst

My personal preference is for "foo-bar".

>
> > Thanks for doing all of this,
>
> Yes! Despite all my nitpicking and disagreements about the Sphinx build
> stuff, I very much appreciate your efforts here, Mauro!

Thanks! Life would be very boring if everybody would have the same
opinion :) So, feel free to disagree with me. Your views are very
welcome, even when differs from my own :)

Regards,
Mauro