Added documentation about the Breadcrumbs widget

[serhiyzhovnir]

Purpose of this pull request

This pull request (PR) adds the documentation about the Breadcrumbs widget.

Affected DevDocs pages

This documentation will have the following links:

• https://devdocs.magento.com/guides/v2.2/javascript-dev-guide/widgets/widget-breadcrumbs.html
• https://devdocs.magento.com/guides/v2.3/javascript-dev-guide/widgets/widget-breadcrumbs.html

Page Look

Links to Magento source code

• https://github.com/magento/magento2/blob/2.3/app/code/Magento/Theme/view/frontend/web/js/view/breadcrumbs.js#L18
• https://github.com/magento/magento2/blob/2.2/app/code/Magento/Theme/view/frontend/web/js/view/breadcrumbs.js#L18
• https://github.com/magento/magento2/blob/2.3/app/code/Magento/Theme/view/frontend/web/js/model/breadcrumb-list.js
• https://github.com/magento/magento2/blob/2.2/app/code/Magento/Theme/view/frontend/web/js/model/breadcrumb-list.js
• https://github.com/magento/magento2/blob/2.3/app/code/Magento/Theme/view/frontend/web/templates/breadcrumbs.html
• https://github.com/magento/magento2/blob/2.2/app/code/Magento/Theme/view/frontend/web/templates/breadcrumbs.html
• https://github.com/magento/magento2/blob/2.3/dev/tests/js/jasmine/tests/app/code/Magento/Theme/view/frontend/web/js/view/breadcrumbs.test.js#L13
• https://github.com/magento/magento2/blob/2.2/dev/tests/js/jasmine/tests/app/code/Magento/Theme/view/frontend/web/js/view/breadcrumbs.test.js#L13

whatsnew
Added a new topic about the Breadcrumbs widget.

[devops-devdocs]

An admin must run tests on this PR before it can be merged.

[serhiyzhovnir]

Hi @rogyar
The explanations of title and label attributes were improved.
Also, here is the picture which describes where breadcrumbs item options are used in the HTML template:
https://raw.githubusercontent.com/magento/devdocs/9a435b6526257e9fa5a68cbe5c2dfa126298ca71/common/images/widget/breadcrumb-list-item-html.png
Thank you!

[jeff-matthews]

Thanks for the new topic @serhiyzhovnir! I made a few editorial suggestions.

[serhiyzhovnir]

Hi @jeff-matthews
All requested changes were added.
Please, check the PR again.
Thank you!

[jeff-matthews]

@serhiyzhovnir, I just noticed some markdown syntax errors in your branch that will fail tests. Please fix the following issues so I can finish processing your PR.

rake test:cicd
Testing Markdown style with mdl ...
guides/v2.2/javascript-dev-guide/widgets/widget-breadcrumbs.md:39: MD009 Trailing spaces
guides/v2.2/javascript-dev-guide/widgets/widget-breadcrumbs.md:51: MD009 Trailing spaces
guides/v2.2/javascript-dev-guide/widgets/widget-breadcrumbs.md:130: MD009 Trailing spaces
guides/v2.3/javascript-dev-guide/widgets/widget-breadcrumbs.md:39: MD009 Trailing spaces
guides/v2.3/javascript-dev-guide/widgets/widget-breadcrumbs.md:51: MD009 Trailing spaces
guides/v2.3/javascript-dev-guide/widgets/widget-breadcrumbs.md:130: MD009 Trailing spaces

A detailed description of the rules is available at https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md

The Markdown linter has found 8 issues```

[serhiyzhovnir]

Hi @jeff-matthews
The trailing spaces were removed.
Please, check the PR again.
Thank you!

[jeff-matthews]

Confirmed. Thanks @serhiyzhovnir.

[jeff-matthews]

running tests

[jeff-matthews]

running tests

[jeff-matthews]

running tests

[jeff-matthews]

@serhiyzhovnir, tests are failing on links:

Running ["LinkChecker::DoubleSlashCheck", "ImageCheck", "HtmlCheck", "LinkCheck", "ScriptCheck"] on ["_site"] on *.html... 


Ran on 2805 files!


- linking to internal hash #breadcrumb_list that does not exist
  *  _site/guides/v2.2/javascript-dev-guide/widgets/widget-breadcrumbs.html (line 374)
     <a href="#breadcrumb_list">Breadcrumbs list</a>
  *  _site/guides/v2.3/javascript-dev-guide/widgets/widget-breadcrumbs.html (line 374)
     <a href="#breadcrumb_list">Breadcrumbs list</a>
rake aborted!
HTML-Proofer found 2 failures!``` 

[serhiyzhovnir]

@jeff-matthews the issue with the link is fixed.
Thank you!

[jeff-matthews]

running tests

[ghost]

Hi @serhiyzhovnir, thank you for your contribution!
Please, complete Contribution Survey, it will take less than a minute.
Your feedback will help us to improve contribution process.