SketchUp
C API function URL link stability?
SketchUp and LayOut C API Documentation Issue
I'm not sure, but it seems that published URL links direct to a C API function are being "orphaned". We have posted these kinds of links hundreds of times in the public forum and here in the issue trackers.
Are these links regenerated each time the docs are updated by doxygen ?
If so, can they be made to be permanent links ?
ping @hilliard-sketchup
Is there an example? The docs are generated per release, but sometimes there are cache issues.
The C API docs are generated by Doxygen and their structure are a result of that. Haven't noticed that the page names changes though - but I'm also not sure of Doxygen tries to mantain such stability. (I assumed, but I'm not sure.)
If you have example URLs we can try to look into it.
Haven't noticed that the page names changes though ...
Not the page names. The generated anchor links directly to a function description.
If you have example URLs we can try to look into it.
I had a bad one in an issue here yesterday, but I think I fixed it. I'll have to go hunting for another bad one.
I see that Thomas posted direct function links last August and they are still good in issue 695.
Okay the bad link that I noticed and fixed 6 days ago is the initial post of #71. Go to that issue and post and expand the edit dropdown and look at the initial edit from MAR 2018. You'll see the invalid link which I fixed 6 days ago.
Also there are invalid links in #90 because a directory was renamed from "developer_center" to "developers" without setting up a redirect.
Also there are invalid links in https://github.com/SketchUp/api-issue-tracker/issues/90 because a directory was renamed from "developer_center" to "developers" without setting up a redirect.
That is something we would be able to control.
The other links I have to look closer at.
The docs are generated per release, but sometimes there are cache issues.
So, if for example the caches of function UUIDs was cleared at some point to fix a doc generation error (such as functions listing on the wrong page,) then it's probable that the situation cannot be fixed. So we'd just have to go on fixing the URLs as the bad ones are found.