Extract Backoffice UI API as Markdown?
# help-with-umbraco
t
Welcome, Currently the doc of Backoffice UI is difficult to navigate, what are the simple tools to use to extract the docs from the Core API as .md files? I ask for that because I plan to create a project to migrate it to a new generation of doc tool.
k
Is https://apidocs.umbraco.com/v13/csharp/api/Umbraco.Cms.Core.html what you mean by "the docs from the Core API"?
t
k
Good question. I can't find that in https://github.com/umbraco/UmbracoDocs
k
i think that is auto generated from the code. (jsdoc i belive) .
t
Correct that is mentioned on the recent docs! but the question what are the tools to extract it, I invite you to share something.
k
think this does it. https://github.com/umbraco/Umbraco-CMS/blob/v13/dev/src/Umbraco.Web.UI.Docs/gulpfile.js so in theory you could customize this and build your own version with diffrent outputs ?
t
Thank you, Kevin. I'm wondered why Umbraco still use angularjs 1.8.3 not the latest angular.
k
AngularJs is completely diffrent from the Angular versions that followed, so its a big update. but thats why v14 is now not using Angular but WebComponents, and Lit & typescript (and in theory you don't need to use Lit, or typescript to code for the backoffice)
t
> and in theory you don't need to use Lit, or typescript to code for the backoffice I think that is because the 14 not stable yet and also doc not ready yet.
k
Well, it's rather because WebComponents can be used independently from Lit and/or TypeScript. The v13 AngularJS backoffice runs on AngularJS and hence development needs to be made in AngularJS. But in practice I think v14 backoffice development will be very hard if not doing it like in e.g. https://docs.umbraco.com/umbraco-cms/v/14.latest-rc/tutorials/creating-a-property-editor I'd wait for a creating-a-property-editor guide in plain JavaScript before even attempting a vite/lit/ts-less approach. 🙂
t
In my case I have a project for backoffice but angularjs is not suitable for new technologies, beside that I try to find a way to bypass that and give something new for community.
5 Views