rocprofv3 doc updates (#982)

* updating rocprofv3

* using rocprofv3

* review updates

* naming standardization

* Update source/docs/how-to/using-rocprofv3.rst

Co-authored-by: Leo Paoletti <164940351+lpaoletti@users.noreply.github.com>

* review comments

* adding API references

* kernel filtering

* Remove Sphinx warn as error

To bypass false warning for linking between rst and md

* remove unused (duplicate) refs in _toc.yml.in

---------

Co-authored-by: Gopesh Bhardwaj <gopesh.bhardwaj@amd.com>
Co-authored-by: Leo Paoletti <164940351+lpaoletti@users.noreply.github.com>
Co-authored-by: Sam Wu <22262939+samjwu@users.noreply.github.com>
Co-authored-by: Peter Jun Park <peter.park@amd.com>

source/docs/_toc.yml.in

@@ -6,14 +6,6 @@ defaults:
 
 root: index
 subtrees:
-  - entries: 
-    - file: what-is-rocprof-sdk
-    - file: buffered_services.md
-    - file: callback_services.md
-    - file: counter_collection_services.md
-    - file: intercept_table.md
-    - file: pc_sampling.md
-    - file: tool_library_overview.md
   - caption: Install
     entries:
     - file: install/installation
@@ -23,8 +15,17 @@ subtrees:
     - file: how-to/samples
   - caption: API reference
     entries:
+    - file: api-reference/buffered_services
+    - file: api-reference/callback_services
+    - file: api-reference/counter_collection_services
+    - file: api-reference/intercept_table
+    - file: api-reference/pc_sampling
+    - file: api-reference/tool_library
     - file: _doxygen/html/index
       title: API library
+  - caption: Conceptual
+    entries:
+    - file: conceptual/comparing-with-legacy-tools
   - caption: License
     entries:
     - file: license