fix: Update CONTRIBUTING-docs.md with instructions for adding metadata to markdown files

[techmannih]

Issue Number:

• Closes [📝 Docs]: Update docs contributing guide: "Add meta-data to newly created markdown file". #1097

This PR updates the CONTRIBUTING-docs.md file to include instructions on adding metadata (YAML front matter) to new markdown files.
Added guidelines for including metadata fields like title, section, date, author, and tags.

[github-actions]

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name	Status	Preview	Last Commit
website	✅ Ready (View Log)	Visit Preview	c4174e7

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (9899bc7) to head (c4174e7).

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #1101   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           10        10           
  Lines          373       373           
  Branches        94        94           
=========================================
  Hits           373       373           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[techmannih]

@DhairyaMajmudar @kwennB please review this PR

[kwennB]

Good work, and thank you for your quick response to this issue.
I have added some comments.

[kwennB]

Here is the style guide to also help. https://github.com/json-schema-org/website/blob/main/pages/md-style-guide.md

[valeriahhdez]

@techmannih, thanks for your hard work on improving the contribution guide! Your changes have made it clearer and more user-friendly.

I do have a small issue regarding the level of detail in the steps. For straightforward tasks, providing too many steps might come across as condescending. To avoid this, we could simplify the instructions by providing a high-level overview and letting the reader fill in the details.

Let me know if you have any questions.

[techmannih]

@kwennB please check now

[valeriahhdez]

Thank you for your work on this PR!

We don't add detailed step-by-step instructions for straightforward tasks, like adding metadata to a .md file. I suggest adding a general instruction and letting the reader fill in the details themselves.

[techmannih]

@valeriahhdez Thanks for the feedback!

I’ve updated the instructions to be more general as suggested. please check now

[valeriahhdez]

Looking good @techmannih!

I left two more comments, but after you addressed them, it will be better to merge

[techmannih]

@valeriahhdez
Which comments are still pending? I believe these have already been updated. Could you please revise them again

[valeriahhdez]

@valeriahhdez Which comments are still pending? I believe these have already been updated. Could you please revise them again

@techmannih I tagged you in the comments I left a few minutes ago

[techmannih]

Looking good @techmannih!

I left two more comments, but after you addressed them, it will be better to merge

@valeriahhdez Which comments are still pending? I think I might have misunderstood.

[valeriahhdez]

Hello @techmannih,

Have you had time to go through the last review I made on this PR?