Skip to content

Latest commit

 

History

History
26 lines (15 loc) · 1.71 KB

INDEX.md

File metadata and controls

26 lines (15 loc) · 1.71 KB

This is a rendered documentation of the TypeScript code provided in the TYPO3 core!

The core contains a lot of JavaScript functionality that can be used in custom backend modules and other places, but it is barely documented (on docs.typo3.org), but it has documentation in the code.

This website is a slightly (automagically) modified version of the code documentation rendered using TypeDoc.

This can be compared to api.typo3.org, which is providing a browsable variant of the PHP doc-comments.

All code and scripts used to generate this documentation can be found on GitHub!
https://github.com/pixeldesu/typo3-typedoc


Note: The comments in the code aren't really perfect for automated documentation generation, so the resulting documentation looks really funky, to say the least. I tried to circumvent this as much as possible with throwing some plugins into the mix, but it only works so-and-so much.

Examples of broken generation behaviour:

  • all the <internal> namespaces. These are technically meant to be several different ones, but there aren't supposed to be more than one, so the generation collides and the list shows many, but the page only lists a single containing class.
  • the export= properties, which contain references to actual classes, because the Core developers decide to not properly do default/named exports and that trips up TypeDoc.

I might write up some plugins myself in the future, but that requires looking into that. So this is the first draft of the generated documentation!

If you know what you are looking for, you can always use the search at the top!