Add Getting Started Section to README and Improve docs/RunApplication.md Instructions

[aymanaboghonim]

Problem Statement

Problem 1: The README is missing a "Getting Started" section and does not reference docs/RunApplication.md for new users.

Problem 2: The README references a contributor guide (CONTRIBUTING.md) that does not exist (404 error).

• Discussion needed: How should we handle contributor guidance? Options could include:
  • Creating a proper CONTRIBUTING.md file
  • Removing the reference and directing to Code of Conduct
  • Adding inline guidance in README
  • Other approaches?

Problem 3: The docs/RunApplication.md file could be improved by:

• Explicitly stating the repository name (AzDevOpsDemoGenerator)
• Specifying the solution file path (src/ADOGenerator.sln) in the steps
• Providing actual GitHub URL instead of placeholders

Proposed Solution

For Problems 1 & 3: Surgical PRs with specific fixes

1. Add Getting Started section to README, referencing docs/RunApplication.md
2. Edit docs/RunApplication.md with explicit repo name and correct solution path

Problem 2 requires community discussion on the best approach.

Implementation Status

• Problem 1: Add Getting Started section to README
• Problem 3: Improve docs/RunApplication.md instructions
• Problem 2: Discussion thread for CONTRIBUTING.md approach

References

• Microsoft Open Source Code of Conduct

---

Note: This issue tracks multiple related documentation improvements. Individual PRs will reference this issue to prevent duplicate work.

[aymanaboghonim]

Implementation Progress

✅ Problem 1 - README Getting Started Section

• PR Add Getting Started section to README #64: Add Getting Started section to README #64
• Status: Submitted and ready for review
• Changes: Added Getting Started section with link to docs/RunApplication.md

✅ Problem 3 - docs/RunApplication.md Improvements

• PR Improve docs/RunApplication.md instructions #65: Improve docs/RunApplication.md instructions #65
• Status: Submitted and ready for review
• Changes: Added repo name, fixed clone URL, specified solution path

🔄 Problem 2 - CONTRIBUTING.md Discussion

• Status: Requires community input on best approach
• Options: Create CONTRIBUTING.md vs. remove broken link vs. inline guidance

---

Note for other contributors: Problems 1 and 3 have active PRs. Please coordinate here before working on similar changes to avoid duplicate effort.