Skip to content

GitLab

Closed
Created by Administrator@rootOwner

Relative Referencing in GitLab Flavor Markdown Problem in 8.x Release

Created by: Balgardner

Updated GitLab from 7.x to current 8.x version recently and noticed a behaviour change in how relative references in links in Gitlab Flavor Markdown documents.

Some context... we have "wiki" projects that are simply normal projects in GitLab as opposed to the actual Wiki that may be created as a component of a regular project.

Here is the typical structure for such a wiki project.

|- wiki-project
              |
              |- README.md (#1)
              |
              |- howtos (folder)
                 |
                 |- README.md (#2
                 |
                 |- howto-do-something (folder)
                    |
                    |- README.md (#3)

And in 'README.md' (#3 (closed)) we have a line at the top of the file as follows:

[Home](/README.md) | [Howtos](/howtos/README.md) | [Howto Do Something](/howtos/howto-do-something/README.md)

In the 7.x GitLab this top line would produce a 'breadcrumb' menu to help the wiki-reader to navigate back up the document tree. Clicking on the 'Home' link would take them back to 'README.md' (#1 (closed)).

In the 8.x GitLab clicking on the 'Home' link now takes the user to the 'README.md' (#3 (closed)) instead. This is not the desired or expected behaviour and seems to be against the guidelines for how the GitLab Flavoured Markup should work.

Am thus raising this as a potential issue here.