[scikit-learn] scikit-learn website and documentation

Chiara Marmo marmochiaskl at gmail.com
Sat Aug 24 07:53:38 EDT 2019


Hi Nicolas,

Working on visual and contents of the the docs is in my skills and I'm
happy to finish the job.
But I'm not a web designer and I don't like to impose myself... :)

Maybe you can check at the Monday meeting if everybody is ok with that and
write down comments in the minutes? For the next meeting I will be
available for collecting specifications, if any.

Gaël, I will check purecss.io: how much customization the basic theme needs
has to be considered too.

CiaoCiao

Chiara

On Friday, August 23, 2019, Gael Varoquaux <gael.varoquaux at normalesup.org>
wrote:
> Hi everyone,
>
> One thing to keep in mind with regards to technical solution is that it
is much easier if they play well with sphinx. In other words, fully fledged
frameworks tend to be harder to slot in.
>
> One tool that I really like is pure css, (https://purecss.io/), because
it is very lightweight  (it's only css, a the name suggests).
>
> Gaël
>
> Sent from my phone. Please forgive typos and briefness.
> On Aug 22, 2019, at 16:21, Nicolas Hug <niourf at gmail.com> wrote:
>>
>> Hi Chiara,
>>
>> Thanks for giving it a shot! I think we can end-up with a nice result
with this theme too.
>>
>> Is this something you'd like to work on more seriously in the future, or
just something to get you started on scikit-learn in general? (Basically,
should Andy still be looking for a web-designer?)
>>
>> Nicolas
>>
>> On 8/18/19 9:43 AM, Chiara Marmo wrote:
>>
>> Dear list, dear devs,
>> I have started to look at the scikit-learn documentation: talking with
developers in July here in Paris, it seemed that you all are concerned by a
reorganization / relooking of the doc and nothing is better than a naïve
beginner to check the effectiveness of a doc ... right? ;)
>> ... and diving into the docs allows me to better familiarize with the
project... :)
>>
>> As CSS and HTML5 are a bit more fun than reStructuredText I've started
to play with styling together with the sphinx contents ... contents ask for
more focusing ... I will be more serious on that starting from September ...
>>
>> From the styling point of view, I am a big fan of this one [1] that you
probably already know and I tried to apply those amazing styles to sphinx
documentation.
>> Then I saw the Andreas tweet [2] ... and decided to stop by to sum up.
>>
>> I've prepared a mock-up for the webpage available here [3].
>> It's a standard build of the doc with the editorial [4] styling (basic
customization needs improvements). The code is available here [5].
>> I've tried not to move too far from the original visual ... because
history is important, especially when you have one! :)
>>
>> I've focused on the homepage so don't expect big modifications in the
doc itself. This is just a proof of concept. If you think I'm on the right
track let me know... I will be happy to be useful on that.
>> If not, or you already have someone taking care of that, please let me
know too and I will find something else to do.
>>
>> Thanks for reading me.
>> Best,
>> Chiara
>>
>> [1] https://html5up.net/
>> [2] https://twitter.com/amuellerml/status/1161298913841885184
>> [3] https://cmarmo.github.io/mockup-skl/
>> [4] https://html5up.net/editorial
>> [5] https://github.com/cmarmo/scikit-learn
>>
>> _______________________________________________
>> scikit-learn mailing list
>> scikit-learn at python.org
>> https://mail.python.org/mailman/listinfo/scikit-learn
>>
>> ________________________________
>> scikit-learn mailing list
>> scikit-learn at python.org
>> https://mail.python.org/mailman/listinfo/scikit-learn
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scikit-learn/attachments/20190824/b0fb7464/attachment.html>


More information about the scikit-learn mailing list