ocaml / v2.ocaml.org Goto Github PK

Inria's page on Portability Issues should be ported to ocamlweb. And add a link to it from somewhere, perhaps in description.html.

Inria's OCaml Programming Guidelines can possibly be considered a tutorial or possibly documentation. Decide which, and either way import directly into ocamlweb.

This menu item points to a section within tutorials.html, but the section has very little content. Either add more content to this section or remove this as a menu item.

The Community > Blogs currently links to an external site. Would be better to serve on ocamlweb's server, and unify styling with ocamlweb.

Content of latest, previous, and older releases should be imported directly into releases.html.

Richard Jones apparently wrote a nice tutorials called Learning OCaml, for C, C++, Perl and Java programmers. The [link](Learning OCaml, for C, C++, Perl and Java programmers) is however dead. Find out if it still exists elsewhere, and add in tutorials/index.html under the Coming From Another Language section.

We should write about a paragraph or more on each book. Should describe roughly what the book is about and who the target audience is.

Provide official OCaml logos. Use Inria's logos page as a starting point, but these are actually using the old name Caml. Someone updated these to "OCaml" and posted somewhere; search mailing list.

A Hundred Lines of OCaml could be good to include under the Discover section. This perhaps nicely fills the role of the previously desired Ocaml in 30 Minutes page.

All items on the Inria resources page should be linked to from somewhere within the ocamlweb project. I believe missing items include at least: bug tracker, subversion and CVS server, and links to releases.

Inria's Contact us page should be incorporated into support.html.

Should the Inria RSS Channel be displayed on front page somewhere? Unlike current News section, it has only small news items. Alternatively, perhaps it should just be added to the Planet, which it currently appears not to be.

This page is quite sparse. List more meetings and regional groups (e.g. NYC OCaml Meetup). Consider listing ICFP and CUFP.

This page is linked to from the "More news" button on the front page. The formatting is completely messed up.

Write an introductory section that lays out the possible installation options at a high-level. For example: "you can install from source, with Godi, with odb, on Mac with godi or homebrew, on Debian with built-in debian package manager, etc". And describe roughly the factors affecting the choice, e.g. "on Debian, the built-in packages are about 1 year behind the latest releases, so very stable but will not have latest versions".

The description.html page currently links to the Inria page on a History of Ocaml, but that content should be imported directly into ocamlweb.

It seems that editor modes do not cope well with <pre> tags. Should we use weberizer to process these tags, removing the spaces at the beginning of the lines and removing all white space (including newlines) before </pre>?

The Inria web site has many cross links that allow you to see oages of related interest. See the “Related Pages” box on e.g. A Hundred Lines of Caml. We should aim to provide such rich navigation possibilities.

The follow this link part refers to Inria site, which is mostly the same content as this page. Remove this link, add the "How to become a member?" section directly to this page, along with the links therein. But the PDFs are in en and fr language and there is a form, so need to make sure these will work in our site.

The Use > OCaml API search menu item currently points to an external server. Would perhaps be better to run this server directly on the ocamlweb server if the tool is stable. Could then make sure it is configured to search over a large set of libraries.

The page Forums où l'on parle de Caml should be imported — uit is referred by the "companies" page.

The content here is okay, but could be designed a bit better. Would be nice to have thumbnails of book covers.

The FAQ page is currently empty. Import content from various external sources, such as the Inria page.

Finish the inclusion of the 99 problems and their solutions.

Create a single page for Caml Light covering all of: the Caml Light section of the Inria front-page, and the three links within it regarding About Caml Light, Latest release, and Manual.

Link to this page from menu and front-page, but not sure where it fits in.

Import Success Stories page from Inria.

Link to subscribe to ocaml-jobs mailing list is asking for username and password. This must be an error. Contact server maintainer and provide link again, which was removed in commit b3e084b.

On the front page and menu, this item is not linked. Is there an existing link or does the content for this need to be newly written?

Inria's books page has many books listed that are not in our books.html page.

Link currently goes to Inria page. This content should be imported directly into ocamlweb repo.

We should somewhere link to caml.inria.fr as the "old Inria site", but not sure where to put it. Ideally, old Inria site would have banner added to top saying the site is deprecated.

Unless we have a readily available 30 minute tutorial, we should probably delete this empty page. The link to try.ocamlpro.com kind of covers the intended purpose of this page already.

Would probably make more sense for these pages to be merged, with the different types of items structured into different sections. There should still be separate links in the menu and frontpage that go to the specific sections.

Information about OCaml's subversion repo should be added directly into ocamlweb.

Inria's Debugging facilities in OCaml page can be considered as either a tutorial or documentation. Decide which and import content directly into ocamlweb.

The tutorials page currently is a merger of content from various places, and some of the tutorials are more well-written than others, and some are embedded directly into this code while others are external links. Organize the content a bit better, and move tutorials that need work to the bottom with a nice "under construction" icon.

Inria site describes availability of OCaml with links to licenses, the normal one and the one for Consortium members. We should import these and link to them from description.html.

Import Inria's OCaml Sidebar for Mozilla page directly into ocamlweb, perhaps into documentation.html.

Installation instructions are all currently too sparse to be of practical use. As a first step, let's clearly outline the various instruction sets we would like, e.g. installing with godi on Unix, installing with godi on Mac OS X (if instructions differ at all from from Unix), installing from source, etc.

Videos page currently has only 3 videos. There are many more OCaml videos out there (such as all the ones from previous OCaml Users Meetings). All should be organized nicely in a youtube account and linked from here.

Write now links to books point to external URLs. It would be better to organize all PDFs into a location on the web server, and provide internal links.

The page A Hundred Lines of OCaml speaks about the “interactive system”. We need to say a word about that, with screenshots—this is indeed an attractive feature for newcomers. Where?

Add companies using OCaml that are not already on this list. Possibly we are missing several since this page has not been updated in a while.

Inria's Using the Format Module page can be considered a tutorial. Import it as a new page under the tutorials/ directory and add a link from tutorials.html.

Import A few papers on OCaml page. Put content in a new papers.htm page, and split Advanced tutorials & Papers menu item into two.

The OCaml: a serious contender page lists past ICFP competitions in which teams using OCaml were winners. This is probably not a good static page to add to ocamlweb. Consider if it should be imported somewhere. If it is check, whether list is up to date.

Contact author of Pleac and request that content be imported directly into ocamlweb repo, and current link should be changed to re-direct to new page on this site.

The Pointers in OCaml page can be considered a tutorial. We can import it as a new page under the tutorials/ directory and link to it from tutorials.html.

The Manuals and Cheat Sheets page has just a list with links. Would be better to give one sentence description of each item.