Refine and reorg

diff --git a/_learning_ocaml.mdwn b/_learning_ocaml.mdwn
index 5e9363b..e19350b 100644 (file)
--- a/_learning_ocaml.mdwn
+++ b/_learning_ocaml.mdwn
@@ -6,22 +6,14 @@
 *   [Code Examples](http://ocaml.org/learn/taste.html) <!-- includes [A Hundred Lines of OCaml](http://caml.inria.fr/about/taste.en.html) -->
 *   [A brief introduction to OCaml](http://www.cs.jhu.edu/~scott/pl/lectures/caml-intro.html)
 *   [Cheat Sheets](http://ocaml.org/docs/cheat_sheets.html)
 *   [Code Examples](http://ocaml.org/learn/taste.html) <!-- includes [A Hundred Lines of OCaml](http://caml.inria.fr/about/taste.en.html) -->
 *   [A brief introduction to OCaml](http://www.cs.jhu.edu/~scott/pl/lectures/caml-intro.html)
 *   [Cheat Sheets](http://ocaml.org/docs/cheat_sheets.html)

+*   [Caml Quick Reference Guide](http://caml.inria.fr/pub/old_caml_site/FAQ/qrg-eng.html)
+*   [A Concise Introduction to Objective Caml](http://www.csc.villanova.edu/~dmatusze/resources/ocaml/ocaml.html), 22 pp. from 2000, a few details may have changed <!-- by David Matuszek, OCaml Wiki's Tutorial page links to this: "gives a concise, yet broad, overview of the language and the standard library; it is rather old but most of what it says remains valid" -->
+*   [OCaml Tutorial by Example](http://xahlee.org/ocaml/ocaml_basics.html), Xah Lee from 2009

 *   Wikipedia on
 [ML](http://en.wikipedia.org/wiki/ML_%28programming_language%29),
 [Caml](http://en.wikipedia.org/wiki/Caml), and
 [OCaml](http://en.wikipedia.org/wiki/OCaml)
 
 *   Wikipedia on
 [ML](http://en.wikipedia.org/wiki/ML_%28programming_language%29),
 [Caml](http://en.wikipedia.org/wiki/Caml), and
 [OCaml](http://en.wikipedia.org/wiki/OCaml)
 

-<!-- -->
-Overviews:
-[A Concise Introduction to Objective Caml](http://www.csc.villanova.edu/~dmatusze/resources/ocaml/ocaml.html), David Matuszek from 2000 "gives a concise, yet broad, overview of the language and the standard library; it is rather old but most of what it says remains valid"; OCaml Wiki's Tutorial page links to this
-[OCaml Tutorial by Example](http://xahlee.org/ocaml/ocaml_basics.html), Xah Lee from 2009
-
-BROKEN overview link: <http://pauillac.inria.fr/caml/FAQ/stephan.html>, aimed at readers who already have some programming experience.
-
-BROKEN briefer: <http://pauillac.inria.fr/caml/FAQ/exemples-eng.html>
-
-BROKEN "Quick Reference Guide" <http://pauillac.inria.fr/caml/FAQ/qrg-eng.html> <http://mirror.ocamlcore.org/caml.inria.fr/pub/old_caml_site/FAQ/qrg-eng.html>
-

 
 <!-- -->
 *   [OCaml Wiki](http://ocaml.org/)
 
 <!-- -->
 *   [OCaml Wiki](http://ocaml.org/)


@@ -46,6 +38,7 @@ BROKEN "Quick Reference Guide" <http://pauillac.inria.fr/caml/FAQ/qrg-eng.html>
 
 *   [Comparing SML to OCaml](http://www.mpi-sws.org/~rossberg/sml-vs-ocaml.html)
 *   [Introduction to OCaml for Haskellers](http://foswiki.cs.uu.nl/foswiki/pub/Stc/BeyondFunctionalProgrammingInHaskell:AnIntroductionToOCaml/ocaml.pdf)
 
 *   [Comparing SML to OCaml](http://www.mpi-sws.org/~rossberg/sml-vs-ocaml.html)
 *   [Introduction to OCaml for Haskellers](http://foswiki.cs.uu.nl/foswiki/pub/Stc/BeyondFunctionalProgrammingInHaskell:AnIntroductionToOCaml/ocaml.pdf)

+*   [A C++/Java programmer's introduction to Objective Caml](http://caml.inria.fr/pub/old_caml_site/FAQ/stephan.html)

 
 
 ## Advanced Docs, listed here for reference ##
 
 
 ## Advanced Docs, listed here for reference ##


@@ -55,26 +48,15 @@ BROKEN "Quick Reference Guide" <http://pauillac.inria.fr/caml/FAQ/qrg-eng.html>
 [usage](https://opam.ocaml.org/doc/Usage.html) |
 [repository](https://opam.ocaml.org/packages/) |
 [issues](https://github.com/OCaml/opam-repository/issues)
 [usage](https://opam.ocaml.org/doc/Usage.html) |
 [repository](https://opam.ocaml.org/packages/) |
 [issues](https://github.com/OCaml/opam-repository/issues)

-* [Style guidelines](http://caml.inria.fr/resources/doc/guides/guidelines.en.html)
-
-## FAQs ##
-
-*   [Beginner FAQ](http://mirror.ocamlcore.org/caml.inria.fr/pub/old_caml_site/FAQ/FAQ_DEBUTANT-eng.html), last modified 2004
-*   [Expert FAQ](http://mirror.ocamlcore.org/caml.inria.fr/pub/old_caml_site/FAQ/FAQ_EXPERT-eng.html), last modified 2004
-*   [INRIA's FAQ](http://caml.inria.fr/resources/doc/faq/)
-*   [OCaml.org FAQ](http://ocaml.org/learn/faq.html)
-*   ---
-*   [Glossary](http://mirror.ocamlcore.org/ocaml-tutorial.org/glossary.html)
+*   [Style guidelines](http://caml.inria.fr/resources/doc/guides/guidelines.en.html)
+*   [FAQ](http://ocaml.org/learn/faq.html)

 
 <!-- -->
 
 <!-- -->

-* [Tips for using the OCaml toplevel](http://mirror.ocamlcore.org/wiki.cocan.org/tips_for_using_the_ocaml_toplevel.html)
-* [Debugging](http://caml.inria.fr/resources/doc/guides/debug.en.html)
-* [Making code run fast](http://mirror.ocamlcore.org/caml.inria.fr/pub/old_caml_site/ocaml/speed.html)
-
----
-
+*   [Debugging](http://caml.inria.fr/resources/doc/guides/debug.en.html)
+*   [Tips for using the OCaml toplevel](http://mirror.ocamlcore.org/wiki.cocan.org/tips_for_using_the_ocaml_toplevel.html)
+*   [Making code run fast](http://mirror.ocamlcore.org/caml.inria.fr/pub/old_caml_site/ocaml/speed.html)
+*   [How to pretty-print?](http://caml.inria.fr/pub/old_caml_site/FAQ/format-eng.html)
+*   OCaml-Tutorial [Glossary](http://mirror.ocamlcore.org/ocaml-tutorial.org/glossary.html)

 *   [Reddit's r/ocaml](https://www.reddit.com/r/ocaml)
 *   [Stack Overflow](https://stackoverflow.com/questions/tagged/ocaml?sort=faq) questions tagged "ocaml"
 *   [Real World OCaml](https://realworldocaml.org/v1/en/html/index.html) (510 pp. text from 2013)
 *   [Reddit's r/ocaml](https://www.reddit.com/r/ocaml)
 *   [Stack Overflow](https://stackoverflow.com/questions/tagged/ocaml?sort=faq) questions tagged "ocaml"
 *   [Real World OCaml](https://realworldocaml.org/v1/en/html/index.html) (510 pp. text from 2013)

-*   [How to intercept stdout?](http://mirror.ocamlcore.org/ocaml-tutorial.org/newbie_faq.html)
-*   [What's the difference between Invalid_argument and Failure?](http://mirror.ocamlcore.org/wiki.cocan.org/cocan%27s_ocaml_faq.html)