{"id":15061082,"url":"https://github.com/mbarbin/doc-experiment-docusaurus","last_synced_at":"2026-01-30T16:05:46.419Z","repository":{"id":249569139,"uuid":"831672075","full_name":"mbarbin/doc-experiment-docusaurus","owner":"mbarbin","description":"Experimenting with docusaurus+odoc","archived":false,"fork":false,"pushed_at":"2024-09-22T08:11:57.000Z","size":1111,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-03T21:30:20.138Z","etag":null,"topics":["docusaurus","ocaml","ocaml-mdx","odoc"],"latest_commit_sha":null,"homepage":"https://mbarbin.github.io/doc-experiment-docusaurus/","language":"Dune","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mbarbin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-21T09:25:57.000Z","updated_at":"2024-12-03T13:39:11.000Z","dependencies_parsed_at":"2024-07-21T22:48:04.730Z","dependency_job_id":"f29e83ee-43ca-405f-9c60-2420056085cd","html_url":"https://github.com/mbarbin/doc-experiment-docusaurus","commit_stats":null,"previous_names":["mbarbin/doc-experiment-docusaurus"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mbarbin/doc-experiment-docusaurus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbarbin%2Fdoc-experiment-docusaurus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbarbin%2Fdoc-experiment-docusaurus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbarbin%2Fdoc-experiment-docusaurus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbarbin%2Fdoc-experiment-docusaurus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mbarbin","download_url":"https://codeload.github.com/mbarbin/doc-experiment-docusaurus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbarbin%2Fdoc-experiment-docusaurus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28914952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T12:13:43.263Z","status":"ssl_error","status_checked_at":"2026-01-30T12:13:22.389Z","response_time":66,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docusaurus","ocaml","ocaml-mdx","odoc"],"created_at":"2024-09-24T23:09:05.717Z","updated_at":"2026-01-30T16:05:46.403Z","avatar_url":"https://github.com/mbarbin.png","language":"Dune","readme":"# doc-experiment-docusaurus\n\n[![CI Status](https://github.com/mbarbin/doc-experiment-docusaurus/workflows/ci/badge.svg)](https://github.com/mbarbin/doc-experiment-docusaurus/actions/workflows/ci.yml)\n\n\u003ch1 align=\"center\"\u003e\n  \u003cimg\n    src=\"./doc/static/img/doc-experiment.png?raw=true\"\n    width=512\n    alt=\"Logo\"\n  /\u003e\n\u003c/h1\u003e\n\nWelcome to this experiment with documentation tools! In this project, we're exploring how Docusaurus can be used to document OCaml projects, while seamlessly integrating with OCaml's dedicated tools like dune, odoc, and ocaml-mdx.\n\nWe envision this project as a template and example for the OCaml community, demonstrating the power and flexibility of combining these tools. We welcome PRs, encourage you to try this setup in your projects, and invite you to share your experiences and suggestions with us. Let's innovate documentation together!\n\n## Status\n\nThis repo is currently experimental and under construction. It's a work in progress, and I'm eager to dive deeper into the features, seeking to enrich this experiment with community feedback and collaboration.\n\n## Acknowledgements\n\nThe essence of the doc-experiment project lies in creating a setup where each tool plays a crucial role, contributing to a seamless documentation experience for OCaml projects. The real magic, however, resides in the hard work, dedication, and innovation embedded within each of these tools. We are immensely thankful for the amazing features these tools offer and even more so to the myriad of contributors behind them.\n\nWe extend our deepest gratitude to the following projects and their contributors:\n\n- [ocaml](https://github.com/ocaml/ocaml): For the OCaml programming language, which is at the heart of our documentation journey.\n- [dune](https://github.com/ocaml/dune): For the Dune build system, enabling us to compile our OCaml projects with ease.\n- [setup-ocaml](https://github.com/ocaml/setup-ocaml): For simplifying the setup of OCaml environments in our CI workflows.\n- [odoc](https://github.com/ocaml/odoc): For the odoc tool, which generates styled HTML documentation from OCaml packages.\n- [ocaml-mdx](https://github.com/realworldocaml/mdx): For allowing us to execute code blocks within our markdown files, ensuring our documentation is always up to date.\n- [sherlodoc](https://github.com/art-w/sherlodoc): For its innovative approach to searching OCaml documentation.\n- [docusaurus](https://github.com/facebook/docusaurus): For providing a platform to bring all our documentation together in a user-friendly and accessible manner.\n\nIn addition to this, we also want to acknowledge the broader community and various other resources that are supporting us in more open-ended ways. Their contributions, though not always directly linked to the core functionality of our project, have significantly enriched our journey and the overall project outcome.\n\n- [OpenArt AI](https://openart.ai): With which we generated the logo for our project.\n\nThe collective effort of all these tools, resources, and their communities has been instrumental in bringing the doc-experiment project to life. We are grateful for their existence and the communities that support them.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmbarbin%2Fdoc-experiment-docusaurus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmbarbin%2Fdoc-experiment-docusaurus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmbarbin%2Fdoc-experiment-docusaurus/lists"}