hi andy,
i would also vote for your heuristic tree (from your blog) to be available
in the documentation.
cheers,
satra
On Mon, Mar 4, 2013 at 4:59 PM, Robert Layton <[email protected]>wrote:
> On 5 March 2013 08:53, Andreas Mueller <[email protected]> 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
>> [email protected]
>> 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
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/scikit-learn-general
>
>
------------------------------------------------------------------------------
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
[email protected]
https://lists.sourceforge.net/lists/listinfo/scikit-learn-general
