Good question, and probably most Tridion developers might wonder when to use them. I would say that both documents have a different purpose and go side by side. The API documentation provides information on methods and usage, SDL Live Content documents provide more information on what to use for your scenario. We get questions like this when we are aboard the new developer, "Which document provides me with the most information."
I look at these simple examples to explain the differences in when to use this documentation.
- which variables are available in the package (vs). What API method should be used when reading variables from a package?
We send Live Docs for the first and API document for the second
- How do I iterate over nested fields (vs), which method do I use to loop through embedded value fields?
We send Live Docs for the first and API document for the second. I see that this question with different variations persists almost every month.
I know I used simple use cases, but sometimes it's easier to keep it simple. Hope this information helps.
Ram g source share