[Tutorial] Fix formatting, grammar, dead link

[mkroening]

This fixes a few issues (formatting, dead links, grammar), I encountered when reading the tutorial.

@hogepodge, could you review this?

[hogepodge]

Thank you for catching these. I would like to request a change in how the links are handled. Instead of direct links, can we please use Sphinx reference links? This will help prevent breaks in the future.

For example, this file has a reference at the top of it:

tvm/gallery/how_to/tune_with_autotvm/tune_relay_x86.py

Line 18 in 2177632

.. _tune_relay_x86:

We can write the link to that as:

:ref:`Auto-tuning a convolution network for x86 CPU <tune_relay_x86>`.

This will make the link more durable and less likely to break if the files are ever moved again. There is documentation for Sphinx that describes this feature more fully. This would be a great start on that. Thank you for sending up this patch, and catching links that I missed in the refactor.

[hogepodge]

One more comment, if the target link doesn't have a reference tag as shown above, it should be added. Any name that doesn't collide with another tag should work. If you need me to build the docs and check once the patch is up, I'd be happy to help out with that.

[jroesch]

Agree that it would be best to make the change @hogepodge suggested to avoid future breakage. Thanks for the fix!

[mkroening]

I pushed three more commits, the last of which adopts sphinx references.

@hogepodge, it would be great if you could build and check if it works.

[mkroening]

I also noticed one code block¹ that looks like having the comments not be outside the block might not be intentional.

Footnotes

1. https://tvm.apache.org/docs/tutorial/tensor_expr_get_started.html#targeting-vector-addition-for-gpus-optional ↩

[mkroening]

I added another commit, fixing a link in README.md.

[hogepodge]

@mkroening I did a pass through the code and fixed a bunch of other links. Rather than send competing patching, can you check the differences in this patch and update to catch the remainder of direct links?

https://github.com/hogepodge/tvm/tree/fix-links

[hogepodge]

Probably easier to compare from this PR: #9314

[mkroening]

@hogepodge, I subtracted #9314 from this PR.

[mkroening]

I think the CI failure should be unrelated to this PR.

[hogepodge]

If you push a basic change it will re-kick the gate job. I’m sorry this is taking so long to merge.

[mkroening]

Another spurious error, trying again.

[mkroening]

Okay, on the sixth try CI passes. 🎉

[hogepodge]

🎉