Q4 Planning OCaml.org

OCaml.org is the Best Resource to Learn OCaml

• Priority: 1
• Why: New OCaml developers should be up to speed and writing OCaml quickly.
  • Redesign OCaml.org Learn Area According to User Feedback (Plat278)
    • Finish the UI designs.
    • Implement all the learn area page designs on ocaml.org.
    • Dark mode in Outreachy Internship.
      • existing pages - what do the components like Hero Section look like in dark mode?
  • New version of the OCaml documentation (Plat194)
    • In-Scope docs
      • Tier 1: Opam Switches, Project Setup, Editor Tweaks, Mutability & Imperative, Functors & Modules
      • Tier 2: Testing w/ Dune, PPX, Map, Set, Hashtbl, Writing an Opam package
      • Tier 3: GADTs, operator associativity rules, C-bindings, Refactoring in OCaml
    • Are all questions in What I wish I knew when learning OCaml
      answered?

Platform Development is Sustainable

• Priority: 2
• Why: The OCaml.org website has to work well so that people do not lose hope and keep sticking with OCaml long enough to create packages or write applications in it.
  • General ocaml.org maintenance (Plat187)
    • Outreachy issues / contributions
    • Don't add new features under disguise of maintenance
    • No voodoo changes because ocaml-docs-ci is currently without maintainers

Notes

• Documentation: Sabine & Cuihtlauac
  • Idea: anonymous documentation feedback form
  • Idea: ask specific questions regarding the examples / document that we have. Ask questions early in writing to the community (e.g. to find good examples).
    • This would make the whole process more community-oriented
  • Can also reach out more actively for reviews within Tarides unless we can work better with the community - e.g. Jules, Emile, Ulysse, Paul-Elliot
• Sayo implementing designs for OCaml.org
  • Maybe we will get some help with CSS work
  • Outreachy mentorship
• Claire finishing Learn area UI, then Main landing page. Carrying on with Design System. Dark mode design for Outreachy Internship.
  • More active outreach for design feedback within Tarides - Jules, Emile, Ulysse, Paul-Elliot, Arthur, Antonin

Capacity Sheet

Sabine

• New version of the OCaml documentation (Plat194): 50%
• General ocaml.org maintenance (Plat187): 15%

Cuihtlauac

• New version of the OCaml documentation (Plat194): 90%

Sayo

• Redesign OCaml.org Learn Area According to User Feedback (Plat278): 75%
• Outreachy mentorship: 20%

Claire (4 days)

• Redesign OCaml.org Learn Area According to User Feedback (Plat278): 40%
  • Dark Mode for Outreachy Internship 10%
  • Design System Maintenance and New Components 15%
• Random spontaneous design tasks (No KR): 10%