doc: Fix broken links in getting_started

[SebastianBoe]

Fix broken links in getting_started. We now use "Implicit Hyperlink
Targets" instead of :ref:. I don't know why :ref: wasn't working.

Signed-off-by: Sebastian Bøe sebastian.boe@nordicsemi.no

[codecov-io]

Codecov Report

Merging #5591 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #5591   +/-   ##
=======================================
  Coverage   52.26%   52.26%           
=======================================
  Files         430      430           
  Lines       41100    41100           
  Branches     7810     7810           
=======================================
  Hits        21481    21481           
  Misses      19106    19106           
  Partials      513      513

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7817622...6836e18. Read the comment docs.

[dbkinder]

@nasif @SebastianBoe Not sure why this change was made? The existing links on http://docs.zephyrproject.org/getting_started/getting_started.html are working as expected?

[SebastianBoe]

@dbkinder : When I clicked either of these links I was redirected to the top of the page instead of to the section. I can't explain that you observed them as working as expected.

[dbkinder]

That's odd. It works fine with firefox on my Linux box, but not with chrome on Windows. Hmmm. I'll look into this a bit more.

[dbkinder]

So the real problem is different browser behavior when linking to an empty tag. When you place a label in a document .. label_here: the HTML that's generated by Sphinx is <span id="label-here"></span>. Technically, spans need to have some content in them, and if there were, the browsers behave the same. For us, this means you can use :ref: syntax if you use the name of the heading rather than the name of the label (e.g., don't bother with adding a label). Your patch to simply use ReST linking does the same thing in this case, so we're good.

[dbkinder]

@SebastianBoe problems caused by empty span tags is fixed in jquery 3.2.1 (yea!). (jquery/jquery#3167) I'll work on getting the new version of jquery into the doc system.