openhab-docs icon indicating copy to clipboard operation
openhab-docs copied to clipboard

Build Error? Transformation Services page looks different on the website

Open pfink opened this issue 7 years ago • 5 comments

Hi, this page does not contain the Available Transformations section even though its present here at GitHub in the 2.3.0 tag, in the master branch and in the 2.3-patch branch. Is this an error with the build or did I miss something?

pfink avatar Nov 04 '18 21:11 pfink

That would be because the script preparing the docs has a dirty hack (I know... 😄) and cuts those files explicitely so that those lists of add-ons don't appear - they are in Jekyll syntax and would not compile. Add-ons are listed at https://www.openhab.org/addons/ and nowhere else. So those sections should be removed eventually and the rest of the content should be moved under "configuration" - that's where they appear on the website.

https://github.com/openhab/website/blob/39cdb0776585737637bf6335494bb5fd46a64f86/prepare-docs.rb#L172

ghys avatar Nov 05 '18 16:11 ghys

Hm, but for me the current "Tranformation Services" section within the configuration page is quite bad... It doesn't even provide a link or a hint where the actual addon documentation with all the details can be found.

pfink avatar Nov 05 '18 17:11 pfink

Then maybe a link to https://www.openhab.org/addons/#transform (which will scroll automatically to the transform addons section) would be enough?

ghys avatar Nov 05 '18 17:11 ghys

Sounds good! Could we also link somehow to "all" addons instead of only the "featured" ones?

pfink avatar Nov 05 '18 20:11 pfink

Could we also link somehow to "all" addons instead of only the "featured" ones?

+1

Definetely makes sense for the frew transformations.

Confectrician avatar Nov 05 '18 20:11 Confectrician