Re: [pytest-dev] Documentation proposal

[Floris Bruynooghe]

Hi Daniele,

On 15 July 2017 at 12:32, Daniele Procida  wrote:
> Dear pytest developers,
>
> I have been speaking to Raphael Pierzina at EuroPython.
>
> I propose to restructure the pytest docmentation, according to this scheme 
>  (the rationale for the scheme is 
> described at length in that article).
>
> The documention already contains most of the content it requires, but I think 
> it could be hugely improved by restructuring it.

This sounds great!  From my point of view this would certainly be
welcome, the navigability of our documentation is a long-standing
issue which could do with improving.

> I'd also change the Sphinx theme to the RTD theme, which improves navigation.

I'd be a little sad to see us unified and conform to everyone else's
look and to loose the logo.  Which bits of navigation are you aiming
to improve?  Would it be possible to do with some refactoring of the
contents and layout of the box on the left?  We could always reach out
to Tobias who did the last themes updates (IIRC) to see if he'd like
fix this.

> Would this be welcome?

Certainly!

Cheers,
Floris
___
pytest-dev mailing list
pytest-dev@python.org
https://mail.python.org/mailman/listinfo/pytest-dev

[pytest-dev] Documentation proposal

[Daniele Procida]

Dear pytest developers,

I have been speaking to Raphael Pierzina at EuroPython.

I propose to restructure the pytest docmentation, according to this scheme 
 (the rationale for the scheme is 
described at length in that article).

The documention already contains most of the content it requires, but I think 
it could be hugely improved by restructuring it.

I'd also change the Sphinx theme to the RTD theme, which improves navigation.

I'm happy to do the work of restructuring. I have done this for other projects 
(django CMS most notably).

Would this be welcome?

Daniele

___
pytest-dev mailing list
pytest-dev@python.org
https://mail.python.org/mailman/listinfo/pytest-dev