UPBGE-Docs icon indicating copy to clipboard operation
UPBGE-Docs copied to clipboard

Furo theme and MKDocs

Open AndreaMonzini opened this issue 3 months ago • 0 comments

Blender Manual now use now a new "furo" Sphinx theme: https://docs.blender.org/manual/en/latest/

"Furo" Sphinx theme: https://github.com/pradyunsg/furo

Blender Developer Docs now use MKdocs https://developer.blender.org/docs/handbook/building_blender/

as explained in the Blender Developer Blog here: https://code.blender.org/2023/12/a-new-developer-documentation-platform/

  • So could be used the "Furo" Sphinx theme for UPGE docs ?
  • As alternative could be considered to use the MKDocs for UPGE docs ?

I personally prefer Markdown based docs like mdBook ( Rust ) or MKdocs ( Python ) But for consistence with Blender probably better to stick with Sphinx reStructuredTex.

thank you

AndreaMonzini avatar Mar 28 '24 13:03 AndreaMonzini