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
