docs icon indicating copy to clipboard operation
docs copied to clipboard

Various regressions

Open mattheworiordan opened this issue 6 years ago • 2 comments

Whilst working today on the docs repo, I noticed various regressions.

Odd rendering

capto_capture 2019-03-06_04-00-00_pm

Yet:

capto_capture 2019-03-06_03-59-50_pm

Using guard no longer works

If I run guard or even nanoc compile, /realtime/types does not update when I update the partials it references. I am forced to delete outputted files.

capto_capture 2019-03-06_04-20-10_pm

Push docs types are incomplete

For example, see this in types.textile

h3(#device-details).
  jsall: DeviceDetails
  ruby:  Ably::Models::DeviceDetails

blang[jsall,ruby].
  <%= partial partial_version('types/_device_details'), indent: 2, skip_first_indent: true %>

The DeviceDetails object only renders in Ruby & JS

Styling in tutorials (on the docs site) don't render code blocks correctly

capto_capture 2019-03-06_04-25-28_pm

┆Issue is synchronized with this Jira Bug by Unito

mattheworiordan avatar Mar 06 '19 16:03 mattheworiordan

For Using guard no longer works, it appears from nanoc 3.8 to 4.0+, changes in partials don't appear to be detected in the way we create partials, I've tried to work out the exact change in the versions which cause this (I've compared identical versions of the docs using 3.8 and 4.0 specifying legacy usage), but not managed to locate it yet.

For Styling in tutorials (on the docs site) don't render code blocks correctly, could you expand on what styling points are the issues please? Just the overlap of text, or more bits? @mattheworiordan

tomczoink avatar Mar 07 '19 15:03 tomczoink

could you expand on what styling points are the issues please?

Normal block:

capto_capture 2019-03-07_07-11-03_pm

See the screenshot I sent, no color coding etc.

mattheworiordan avatar Mar 07 '19 19:03 mattheworiordan