[all-commits] [llvm/llvm-project] 679d5a: [docs] Rewrite libc docs from reST to markdown (#2...

Reid Kleckner via All-commits all-commits at lists.llvm.org
Fri Jul 10 01:46:58 PDT 2026


  Branch: refs/heads/users/rnk/libc-md-rename
  Home:   https://github.com/llvm/llvm-project
  Commit: 679d5a2cc4204c0a31176d36e5eb39900a12e813
      https://github.com/llvm/llvm-project/commit/679d5a2cc4204c0a31176d36e5eb39900a12e813
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-07-10 (Fri, 10 Jul 2026)

  Changed paths:
    M libc/docs/arch_support.md
    M libc/docs/build_and_test.md
    M libc/docs/build_concepts.md
    M libc/docs/compiler_support.md
    M libc/docs/conf.py
    M libc/docs/contributing.md
    M libc/docs/dev/building_docs.md
    M libc/docs/dev/builtin_compatibility.md
    M libc/docs/dev/code_style.md
    M libc/docs/dev/config_options.md
    M libc/docs/dev/entrypoints.md
    M libc/docs/dev/fuzzing.md
    M libc/docs/dev/header_generation.md
    M libc/docs/dev/implementation_standard.md
    M libc/docs/dev/implementing_a_function.md
    M libc/docs/dev/index.md
    M libc/docs/dev/modular_format.md
    M libc/docs/dev/printf_behavior.md
    M libc/docs/dev/source_tree_layout.md
    M libc/docs/dev/syscall_wrapper_refactor.md
    M libc/docs/dev/undefined_behavior.md
    M libc/docs/full_cross_build.md
    M libc/docs/full_host_build.md
    M libc/docs/getting_started.md
    M libc/docs/hand_in_hand.md
    M libc/docs/index.md
    M libc/docs/overlay_mode.md
    M libc/docs/platform_support.md
    M libc/docs/porting.md
    M libc/docs/talks.md

  Log Message:
  -----------
  [docs] Rewrite libc docs from reST to markdown (#208374)

Tracking issue: https://github.com/llvm/llvm-project/issues/201242
Migration guide docs:
https://llvm.org/docs/SphinxQuickstartTemplate.html#markdown-migration-guidelines
RFC:
https://discourse.llvm.org/t/rfc-make-myst-markdown-the-llvm-docs-format-rip-rest/90840

This was prepared with rst2myst plus LLM-assisted cleanup. I paged
through all the generated HTML looking for migration artifacts, and all
of the differences I could find appear to be formatting error
corrections. Please spot check my work and approve if it looks good. You
can use the HTML links below to confirm it renders properly.

-----

Before/after validation links:

| Source file | Before HTML | After HTML |
| --- | --- | --- |
| `libc/docs/arch_support.md` |
[before](https://libc.llvm.org/arch_support.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/arch_support.html)
|
| `libc/docs/build_and_test.md` |
[before](https://libc.llvm.org/build_and_test.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/build_and_test.html)
|
| `libc/docs/build_concepts.md` |
[before](https://libc.llvm.org/build_concepts.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/build_concepts.html)
|
| `libc/docs/compiler_support.md` |
[before](https://libc.llvm.org/compiler_support.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/compiler_support.html)
|
| `libc/docs/contributing.md` |
[before](https://libc.llvm.org/contributing.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/contributing.html)
|
| `libc/docs/dev/building_docs.md` |
[before](https://libc.llvm.org/dev/building_docs.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/building_docs.html)
|
| `libc/docs/dev/builtin_compatibility.md` |
[before](https://libc.llvm.org/dev/builtin_compatibility.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/builtin_compatibility.html)
|
| `libc/docs/dev/code_style.md` |
[before](https://libc.llvm.org/dev/code_style.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/code_style.html)
|
| `libc/docs/dev/config_options.md` |
[before](https://libc.llvm.org/dev/config_options.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/config_options.html)
|
| `libc/docs/dev/entrypoints.md` |
[before](https://libc.llvm.org/dev/entrypoints.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/entrypoints.html)
|
| `libc/docs/dev/fuzzing.md` |
[before](https://libc.llvm.org/dev/fuzzing.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/fuzzing.html)
|
| `libc/docs/dev/header_generation.md` |
[before](https://libc.llvm.org/dev/header_generation.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/header_generation.html)
|
| `libc/docs/dev/implementation_standard.md` |
[before](https://libc.llvm.org/dev/implementation_standard.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/implementation_standard.html)
|
| `libc/docs/dev/implementing_a_function.md` |
[before](https://libc.llvm.org/dev/implementing_a_function.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/implementing_a_function.html)
|
| `libc/docs/dev/index.md` |
[before](https://libc.llvm.org/dev/index.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/index.html) |
| `libc/docs/dev/modular_format.md` |
[before](https://libc.llvm.org/dev/modular_format.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/modular_format.html)
|
| `libc/docs/dev/printf_behavior.md` |
[before](https://libc.llvm.org/dev/printf_behavior.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/printf_behavior.html)
|
| `libc/docs/dev/source_tree_layout.md` |
[before](https://libc.llvm.org/dev/source_tree_layout.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/source_tree_layout.html)
|
| `libc/docs/dev/syscall_wrapper_refactor.md` |
[before](https://libc.llvm.org/dev/syscall_wrapper_refactor.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/syscall_wrapper_refactor.html)
|
| `libc/docs/dev/undefined_behavior.md` |
[before](https://libc.llvm.org/dev/undefined_behavior.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/dev/undefined_behavior.html)
|
| `libc/docs/full_cross_build.md` |
[before](https://libc.llvm.org/full_cross_build.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/full_cross_build.html)
|
| `libc/docs/full_host_build.md` |
[before](https://libc.llvm.org/full_host_build.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/full_host_build.html)
|
| `libc/docs/getting_started.md` |
[before](https://libc.llvm.org/getting_started.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/getting_started.html)
|
| `libc/docs/hand_in_hand.md` |
[before](https://libc.llvm.org/hand_in_hand.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/hand_in_hand.html)
|
| `libc/docs/index.md` | [before](https://libc.llvm.org/index.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/index.html) |
| `libc/docs/overlay_mode.md` |
[before](https://libc.llvm.org/overlay_mode.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/overlay_mode.html)
|
| `libc/docs/platform_support.md` |
[before](https://libc.llvm.org/platform_support.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/platform_support.html)
|
| `libc/docs/porting.md` | [before](https://libc.llvm.org/porting.html)
| [after](https://llvmdocs.staging.reidkleckner.dev/libc/porting.html) |
| `libc/docs/talks.md` | [before](https://libc.llvm.org/talks.html) |
[after](https://llvmdocs.staging.reidkleckner.dev/libc/talks.html) |



To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications


More information about the All-commits mailing list