Docs : Content Organization and Documentation Updates

[AdarshRawat1]

Configuration changes

After integration of Doxygen v1.12.0 into our workflow., we've made several improvements to streamline the documentation process with Support of Doxygen Style comments.

• Enabled Pretty URLs for Documentation: Previously, Doxygen generated long and cumbersome URLs, such as https://p4lang.github.io/p4c/md__2home_2runner_2work_2p4c_2p4c_2docs_2_r_e_a_d_m_e.html. The URLs have now been updated to be more user-friendly, for example: https://p4lang.github.io/p4c/getting_started.html.
• Added Doxygen TOC: Introduced a Doxygen-generated table of contents, replacing the GitHub Markdown TOC.
• Hidden page/subsection include command.

Documentation Maintenance

• Added clear documentation inclusion notes on all relevant markdown files.

Changes in Content

• Combined all the Backends into one section.

Removed Sections

• Revision History
• Deprecated List
• Todo List
• Namespaces
• Classes

Merged Sections

• PSA implementation for eBPF backend as a subsection under eBPF Backend

• Combined P4Tools - Testing Tools For P4 Targets and P4Tools Contributors under a new page P4tools

• Merged P4Testgen Benchmarks and P4Testgen BMv2 target tests in the P4Testgen Page

• Combined Introduction to uBPF Backend
  ►uBPF Backend test programs
  ►uBPF Backend testing in a single page titled uBPF Backend .

• Merged Coding Standard into Contribute to the P4 Compiler Project

• Merge Overview into P4C

• Merged Common P4C utility functions as a subsection under P4C

• Merged BMv2 "pna_nic" Backend into Behavioral Model Backend

• Merge portable_common section under Behavioral Model Backend

• merged P4C Intermediate Representation (IR) Classes as a subsection of P4 Compiler Intermediate representation .

Moved Sections

• Changelogs to the end of list. Renamed to - > "Releases"

Renamed Sections

• Change the top of tree view from "P4C" -> "P4 Compiler Documentation
• "P4 Compiler Intermediate Representation" -> "P4C Intermediate Representation (IR),"
• "P4C Intermediate Representation (IR) Classes" -> "Classes. (Because now it is a subsection under IR so it doesn't require long heading).

[github-actions]

A preview of this PR is available at:	Preview Link
📂 View the source code here:	View Source Code
🔧 Commit used for deployment:	adb7e384a80cc2017caa7f826494ddae0de5cde4

Note: Changes may take a few seconds to appear on GitHub Pages. Please refresh the page if you do not see the updates immediately.

[fruffy]

@AdarshRawat1 Looks like previews are working now!

[fruffy]

I would factor out the textual and description changes to READMEs from the doxygen-internal changes. For example, moving the addition of the front end, mid end README and changes to lib, ir etc to a separate PR. It might make it easier to give a review here.

[AdarshRawat1]

I would factor out the textual and description changes to READMEs from the doxygen-internal changes. For example, moving the addition of the front end, mid end README and changes to lib, ir etc to a separate PR. It might make it easier to give a review here.

Sure!! I'll shift the changes to a seperate PR.

[AdarshRawat1]

@fruffy Migrated the changes and updated the description of PR.