On 5 March 2013 08:53, Andreas Mueller <amuel...@ais.uni-bonn.de> wrote:
> Hi everybody.
> In the survey (that we should do a full evaluation of soon), some people
> complained a bit about our website:
> Documentation would be hard to find and little interconnected.
>
> Examples of better package websites that people liked better were
> Pandas: http://pandas.pydata.org/pandas-docs/stable/
> Caret: http://caret.r-forge.r-project.org/
>
> Let us talk first about the organization:
> One thing I immediately noticed was that caret and pandas documentations
> are somewhat flatter organized
> and have some high level entry points.
> On the scikit-learn site, it is basically impossible to navigate without
> using the brower's search function imho.
>
> So I propose we rework the navigation a bit.
>
> First there are some simple changes that might make a difference:
>
> Rename the "download" link to "installation" - as it shows the
> installation page.
> On the "user guide" page, only show the core part of the user guide, not
> the installation (that is under "installation", right?)
> and not the References (that is under "references", right?).
> Last but not least: add a "home" button - that tells people that landed
> on the user guide, that there is actually a landing page
> (that is not so easy to discover imho).
>
>
> Then there is some larger changes we might think about:
>
> I think our website could benefit from having a larger, more specific
> top-level menu.
> Currently some pages, like the presentation page, the developer guide,
> and the what's new page,
> are only available from the landing page (which is hard to get to imho).
>
> These could very well be in a top-level menu.
> There was also Mathieu's idea of having a list of all models. That would
> be great. And it should also be a top level entry.
> If it is buried somewhere in the User Guide, no-one will find it.
>
> Btw, I think the current usage of the sidebar is mostly a waste of
> space. For example, in the User Guide, it is completely
> empty on the main page. In the references it basically duplicates the
> overview page, but a little less readable.
> Maybe we should think about having a menu on the side? Or somehow
> utilize it better as a sub-menu?
>
> I dream of a day where I can look up a feature / parameter without
> pressing "ctrl + f"
>
> What do you think?
>
> Cheers,
> Andy
>
> PS very tentative list of possible top-level menu items:
>
> Home
> Installation
> Getting Started (includes links to videos / talks?)
> Algorithms
> Tutorials
> User Guide
> Examples
> Development (includes what's new?)
> References
>
>
> ------------------------------------------------------------------------------
> Everyone hates slow websites. So do we.
> Make your web apps faster with AppDynamics
> Download AppDynamics Lite for free today:
> http://p.sf.net/sfu/appdyn_d2d_feb
> _______________________________________________
> Scikit-learn-general mailing list
> Scikit-learn-general@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/scikit-learn-general
>
Sounds like some great changes.
For the algorithms, I would recommend splitting by application. Rather than
"Supervised learning" and "Unsupervised learning", have:
- Classification
- Regression
- Feature Selection
- Feature Reduction/Creation
- Clustering
- Optimising Parameters
- Evaluating
- Text Mining
and so on...
Given, under Andy's suggestions, that algorithms would become a more
focused part of the site, the increase in the number of headings shouldn't
matter too much. (also, it's flatter)
- Robert
--
Public key at: http://pgp.mit.edu/ Search for this email address and select
the key from "2011-08-19" (key id: 54BA8735)
------------------------------------------------------------------------------
Everyone hates slow websites. So do we.
Make your web apps faster with AppDynamics
Download AppDynamics Lite for free today:
http://p.sf.net/sfu/appdyn_d2d_feb
_______________________________________________
Scikit-learn-general mailing list
Scikit-learn-general@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/scikit-learn-general
