umbraco/OurUmbraco

Updating the Angular documentation

Closed this issue · 3 comments

From what I can tell, the Angular documentation hasn't been updated for at least nine months. For instance, the commit below rectifies an example for entityResource,

umbraco/Umbraco-CMS@296d796

But the wrong example is still visible when viewing the documentation:

https://our.umbraco.com/apidocs/v8/ui/#/api/umbraco.resources.entityResource#methods_getbyid

I'm not entirely sure what is preventing HQ from updating the docs, but I think I recall hearing it was an issue with no longer being able to deploy the docs automatically.

If there isn't a quick fix towards deploying automatically again, could HQ then occasionally update the docs manually so we don't have waits months for changes to make their way to the website?

We should really get this automated somehow but not sure what's required. Will have to look into it.

Great 👍

Btw, this is somewhat related to my issue about versioned docs: #378

Hiya @abjerner,

Just wanted to let you know that we noticed that this issue got a bit stale and might not be relevant any more.

We will close this issue for now but we're happy to open it up again if you think it's still relevant (for example: it's a feature request that's not yet implemented, or it's a bug that's not yet been fixed).

To open it this issue up again, you can write @umbrabot still relevant in a new comment as the first line. It would be super helpful for us if on the next line you could let us know why you think it's still relevant.

For example:

@umbrabot still relevant
This bug can still be reproduced in version x.y.z

This will reopen the issue in the next few hours.

Thanks, from your friendly Umbraco GitHub bot 🤖 🙂