Karthik Chikmagalur <karthikchikmaga...@gmail.com> writes: > Suppose a package author is aware that Org now supports previews for > custom link types and wants to add a preview. What section of the > manual would they expect to find this information?
"Adding hyperlink types", I think. As you guessed. > My current plan for the manual is the following: > > - (info "(org) Adding Hyperlink Types"): Include an example of defining > a :preview function for a link type. > > - (info "(org) Images"): When replacing the description of > org-toggle-inline-images with org-link-preview, mention that it can be > used to preview all supported link types. Sounds good. > Should I rename the node "(org) Images" to something else, like "(org) > Images and supported links"? > Should I create a new node instead under (info "(org) Markup for Rich > Contents"), titled "Links"? I feel that it may be too obscure. I'd prefer an emphasis on images in the node titles - that's what new users can recognize better. Maybe rename "Images" to "Images and previews" and then put two subsections inside - one for images (the existing one) and one for more general link previews. -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
