fix(docs): Documenter docstring parse + Vitepress index frontmatter

Author: dr-ko

docs/src/.vitepress/config.mts

@@ -36,7 +36,7 @@ const settingsItems = [
 const codeItemsNav = [
   { text: 'Sindbad', link: '/pages/code/api/Sindbad' },
   // TEM should land on the package/module docstring page
-  { text: 'SindbadTEM (TEM)', link: '/pages/code/api/SindbadTEM' },
+  { text: 'TEM', link: '/pages/code/api/SindbadTEM' },
   // Modules should land on an index page
   { text: 'Modules', link: '/pages/code/api/modules/index' },
   // Extensions should land on the extensions index

docs/src/index.md

@@ -1,4 +1,3 @@
-```@raw html
 ---
 # https://vitepress.dev/reference/default-theme-home-page
 layout: home
@@ -52,9 +51,6 @@ features:
     link: /pages/code/api/Sindbad
     details: Generated API documentation for the Sindbad / SindbadTEM codebase.
 ---
-```
-
-
 ## 🚧🚧 UNDER PREPARATION FOR RELEASE 🚧🚧
 
 SINDBAD is being prepared for release with a manuscript, for which a preprint is available at

src/Types/Types.jl

@@ -59,13 +59,6 @@ module Types
         false
     end
 
-    function _attach_binding_doc!(mod::Module, sym::Symbol, doc_txt::AbstractString, T::Type)
-        b = Base.Docs.Binding(mod, sym)
-        ds = Base.Docs.DocStr(Core.svec(String(doc_txt)), T, Dict{Symbol, Any}())
-        Base.Docs.doc!(mod, b, ds)
-        return nothing
-    end
-
     # ------------------------- SindbadTypes ------------------------------------------------------------
     include("LandTypes.jl")
     include("ArrayTypes.jl")
@@ -106,7 +99,10 @@ module Types
                 sym = Symbol(nameof(st))
                 if isdefined(@__MODULE__, sym) && !_binding_hasdoc(@__MODULE__, sym) && !_type_hasdoc(st)
                     doc_txt = get_type_docstring(st, purpose_function=purpose)
-                    _attach_binding_doc!(@__MODULE__, sym, doc_txt, st)
+                    # Use `@doc` so the stored doc is the usual Markdown-based form that
+                    # Documenter expects, while still guarding with a Julia-1.10-safe
+                    # "has docs?" check above.
+                    @eval Base.Docs.@doc $doc_txt $sym
                 end
             end
             _attach_type_docstrings!(st)