[Docs] Add initial CHANGELOG.md with changelogs from previous release

[AdarshRawat1]

What does change log contain:

• A summary of major changes
• Details on new features
• Bug fixes
• Other notable improvements and modifications

Impact:

• This changelog will be available on the documentation site.
• Users and contributors can easily track changes and updates over time through the documentation site.

Screenshot

Reference

Based on this discussion - #4692 (comment)

Other changes

bumped up p4c_layout.xml v1.8.12 -->v1.11.0

[fruffy]

Is this ready for review?

[AdarshRawat1]

Is this ready for review?

Yes, we can merge this, as this is just the initial configuration for changelogs.

I'm formatting the previous changelogs as per the current release format.[i.e. Under categories - Breaking changes , p4 specific implementation etc]. It can be done separately.

[fruffy]

I would remove all the commits before the earliest known release. They are just noise. We can add a note that only the commit history is available for those.

[fruffy]

Also shouldn't this be in the top-level?
We can also add some boilerplate to explain our semantic versioning. The release cadence is monthly and the Major/Minor/Patch versions are tied to the P4 specification. The revision (the last number) is incremented each month.

[AdarshRawat1]

I added notes for semantics and previous commits, though they do need some polishing.

[AdarshRawat1]

I would remove all the commits before the earliest known release. They are just noise. We can add a note that only the commit history is available for those.

Should we also remove the current latest release when the next release comes out next month, or should we append the newer release to the list?

[fruffy]

I was looking at https://github.com/AdarshRawat1/p4c/blob/Docs-Changelogs/CHANGELOG.md

The version that included previous releases was fine, but that list only went until v1.2.2. We can keep the changelog until that point, then delegate to the git commit history before that.

[AdarshRawat1]

Oh Thanks !! , I understand it now.

[AdarshRawat1]

Screenshot of current changelog configuration [With awesome CSS] - view live here

[fruffy]

Screenshot of current changelog configuration [With awesome CSS] - view live here

Looks great!

[Dscano]

Looks good to me

[fruffy]

Let's get this in, we can always improve minor problems later.