Consider hiding the breadcrumb at the top level and changing its postion

[at055612]

When you are at the top level of a section the breadcrumb shows a single link like so

which looks a little odd as it is not obvious that is is a breadcrumb. With >1 item it is fine

Thus consider changing breadcrumb.html to hide the nav for a single item.

{{ $isSingle := true -}}
{{ with .Parent -}}
  {{ $isSingle = .IsHome -}}
{{ end -}}
{{ if not $isSingle }}
<nav aria-label="breadcrumb" class="td-breadcrumbs
    {{- if $isSingle }} td-breadcrumbs__single {{- end }}">
  <ol class="breadcrumb">
    {{- template "breadcrumbnav" (dict "p1" . "p2" .) }}
  </ol>
</nav>
{{ end }}
...

For me this then looks like:

Also, when you have the archived banner visible, the breadcrumbs appear below it which looks a little odd.

I think it looks better if the breadcrumbs always remain at the top like so

i.e. in layouts/docs/baseof.html

...
          <main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main">
            {{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
            {{ partial "version-banner.html" . }}
            {{ block "main" . }}{{ end }}
          </main>
...

Appreciate this is all subjective.

[chalin]

You can hide single-element breadcrumbs using custom styling as mentioned in #786, that is:

.td-breadcrumbs__single { display: none !important; }

FYI, There's already an issue open to ensure that that get's documented (#810).

[chalin]

As for the relative order of the breadcrumbs & banner, that's ... subjective, as you put it :). I prefer the current design in that respect.

[at055612]

Thanks for the .td-breadcrumbs__single tip. Understand you position about the banner/breadcrumb order. Happy to close.

[chalin]

@at055612, I agree with your request here, that most projects I've worked on prefer for the single breadcrumb in index pages to be hidden. Here's the change:

• Hide index-page single breadcrumb #2160