owned this note owned this note

v3.ocaml.org Feedback Retrospective

Before Launch

✅ Write Privacy Policy
✅ BUG - Broken release links (#165)
✅ Benchmark visualisation for the homepage compiler section
✅ Implement a syndicated RSS feed for the OCaml Blog
- https://github.com/ocaml/v3.ocaml.org-server/issues/242
✅ The package search page is too dense
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/13
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/17
✅ Responsive layout broken in package overview (#227)
✅ The Standard Library API is not easily discoverable
✅ The strong community section on the homepage is broken on mobile
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/25
✅ Create Platform page in the documentation
✅ Right navbar doesn't scroll if larger that the page (http://localhost:8080/learn/ocaml-programming-guidelines). Probably on package doc as well
✅ Create a governance page on the website
- https://github.com/ocaml/v3.ocaml.org-server/pull/271
✅ BUG - The tags in package overview should link to a search page
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/17
- https://github.com/ocaml/v3.ocaml.org-server/pull/272
✅ BUG - The package authors in package overview should link to a search page
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/17
- https://github.com/ocaml/v3.ocaml.org-server/pull/272
✅ BUG - Swiper is not vendored
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/27
- PR: https://github.com/ocaml/v3.ocaml.org-server/pull/268
✅ Button to edit a documentation page
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/6
- https://github.com/ocaml/v3.ocaml.org-server/pull/274
✅ Missing links to the mailing lists in community
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/18
- https://github.com/ocaml/v3.ocaml.org-server/pull/275
✅ Move community links to the top
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/14
✅ Rename Discuss to something more general (e.g. forums) in community
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/14
- https://github.com/ocaml/v3.ocaml.org-server/pull/275
✅ "OCaml" should be more visible on the homepage
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/12
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/13

After Launch

BUG - The homepage toplevel is broken on Debian's Firefox 78.15.0esr
- https://github.com/ocaml/v3.ocaml.org-server/issues/284
The package documentation is hard to use on small screens
- https://github.com/ocaml/v3.ocaml.org-server/issues/285
Navigate to the source page documentation
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/17
Search through the documentation
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/5
Package search should be sorted by popularity and displays the usage number
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/5
The problem page should keep the statement when displaying the solution
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/9

To Discuss

Consider removing the logos from the homepage, or moving them down.
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/3
Option to override the README in the documentation
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/17
Document other build systems (nix, Bazel, etc.)
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/17
The featured papers are not relevant
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/9
The documentation status indicator is confusing
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/30
- https://discuss.ocaml.org/t/v3-ocaml-org-getting-ready-to-launch/9146/13

Cheatsheet

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`	在筆記中貼入程式碼
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.

Select a repo