Some org-mode elements expose "contents-begin" and "contents-end"
properties as buffer positions, whereas other elements such as verbatim and
org-src-block expose a "value" property in the form of a string.
I think it would be preferable to also expose the value by beginning and
ending buffer positions for the following reasons:
- Consistency with elements that expose contents-begin and contents-end.
- More powerful. In my evil-org plugin I want to be able to mark the value
property of the org element at point (so the user can do stuff like easily
copy the code of the current code block), but to do so I need the beginning
and ending position in the buffer of "value". The org-element API does
currently not provide clean way to retrieve these positions.
- It's usually more efficient to return the beginning and ending positions
than to retrieve the substring that contains the value, which may require a
large buffer partition to be copied.