[docs] Update the llvm/example section

[pooja2299]

Summary

Added details about the llvm/example section.

[pooja2299]

Improved llvm/example section

[pooja2299]

Removed ExceptionDemo and brainF topic

[xgupta]

LGTM, Thanks for the patch!

Also adding @fhahn and @reames as reviewers as it is an important doc of LLVM.

[reames]

Minor optional suggestions, but LGTM to me too.

@xgupta - I suggest avoiding both LGTMing and asking for another reviewer. Given LLVM is a single accept culture, this can be really confusing to new contributors. I suggest wording along the lines of "This seems good to me, but I'd like a second opinion before LGTMing. Maybe X and Y can confirm?" Alternatively, you could simply LGTM if you were comfortable with that. Another phrasing might be "LGTM, but please wait N days before submitting in case X or Y have additional comments".

llvm/docs/GettingStarted.rst

820–834

The last part of this sentence gets a bit complicated, can I suggest:

Some simple examples showing how to use LLVM as a compiler for a custom language - including lowering, optimization, and code generation.

826

Maybe replace "both static and JIT" with " both static (ahead of time) and various approaches to Just In Time (JIT) compilation."

[xgupta]

In D101284#2723554, @reames wrote:

Minor optional suggestions, but LGTM to me too.

@xgupta - I suggest avoiding both LGTMing and asking for another reviewer. Given LLVM is a single accept culture, this can be really confusing to new contributors. I suggest wording along the lines of "This seems good to me, but I'd like a second opinion before LGTMing. Maybe X and Y can confirm?" Alternatively, you could simply LGTM if you were comfortable with that. Another phrasing might be "LGTM, but please wait N days before submitting in case X or Y have additional comments".

Yes @reames, I agree, I will remember your suggestion from next time. I was just a little afraid that I am also not very experienced so giving only my acceptance to commit changes is a little risky(IMO). If next time I have confusion I only add an appropriate reviewer for that patch.

( Additional context here is that @pooja2299 is an Outreachy applicant and I am co-mentor for one project, so she adds me on every review so I will aware of her progress but I may not be the perfect reviewer for every patch)

[pooja2299]

Edited few lines as suggested in comments.

[pooja2299]

@fhahn and @reames can you please review this patch?

[reames]

In D101284#2738040, @pooja2299 wrote:

@fhahn and @reames can you please review this patch?

I have already given an LGTM, what more are you expecting?

[pooja2299]

In D101284#2739140, @reames wrote:

In D101284#2738040, @pooja2299 wrote:

@fhahn and @reames can you please review this patch?

I have already given an LGTM, what more are you expecting?

I meant after the changes that you asked .
Thanks a lot 😄 👍

[reames]

In D101284#2739148, @pooja2299 wrote:

In D101284#2739140, @reames wrote:

In D101284#2738040, @pooja2299 wrote:

@fhahn and @reames can you please review this patch?

I have already given an LGTM, what more are you expecting?

I meant after the changes that you asked .
Thanks a lot 😄 👍

Ah, sorry, I'm so used to LLVM phrasing that I forgot "LGTM w/minor optional comments" isn't widely understood. For us, that generally means you can land with the changes made (if you decide to) without further review.

[pooja2299]

In D101284#2739176, @reames wrote:

In D101284#2739148, @pooja2299 wrote:

In D101284#2739140, @reames wrote:

In D101284#2738040, @pooja2299 wrote:

@fhahn and @reames can you please review this patch?

I have already given an LGTM, what more are you expecting?

I meant after the changes that you asked .
Thanks a lot 😄 👍

Ah, sorry, I'm so used to LLVM phrasing that I forgot "LGTM w/minor optional comments" isn't widely understood. For us, that generally means you can land with the changes made (if you decide to) without further review.

Oh ok 👍 I will remember this next time.

llvm/docs/GettingStarted.rst

 One useful source of information about the LLVM source base is the LLVM `doxygen
 <http://www.doxygen.org/>`_ documentation available at
 `<https://llvm.org/doxygen/>`_.  The following is a brief introduction to code
 layout:
 
 ``llvm/examples``
 -----------------
 
-Simple examples using the LLVM IR and JIT.
+- Some simple examples showing how to use LLVM as a compiler for a custom 
+  language - including lowering, optimization, and code generation.
+
+- Kaleidoscope Tutorial: Kaleidoscope language tutorial run through the 
+  implementation of a nice little compiler for a non-trivial language 
+  including a hand-written lexer, parser, AST, as well as code generation 
+  support using LLVM- both static (ahead of time) and various approaches to 
+  Just In Time (JIT) compilation. 
+  `Kaleidoscope Tutorial for complete beginner 
+  <https://llvm.org/docs/tutorial/MyFirstLanguageFrontend/index.html>`_.
+
+- BuildingAJIT: Examples of the `BuildingAJIT tutorial 
+  <https://llvm.org/docs/tutorial/BuildingAJIT1.html>`_ that shows how LLVM’s 
+  ORC JIT APIs interact with other parts of LLVM. It also, teaches how to 
+  recombine them to build a custom JIT that is suited to your use-case.
 
 ``llvm/include``
 ----------------
 
 Public header files exported from the LLVM library. The three main subdirectories:
 
 ``llvm/include/llvm``