Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Oct 3, 2025

Changes

This PR reorganizes the repository documentation by moving development-specific content from the main README.md to a new dedicated getting started guide.

Problem

The README.md contained ad hoc notes and detailed development setup instructions at the bottom that were primarily useful for developers setting up their local environment. This made the README longer than necessary and mixed high-level project information with detailed setup instructions.

Solution

  • Created a new docs/ folder to house documentation
  • Created docs/getting-started.md with comprehensive development setup instructions including:
    • Prerequisites (Visual Studio, .NET 9.0 SDK)
    • Startup steps for running the site locally
    • Detailed environment configuration with secret manager setup
    • Testing secret values for HCaptcha
  • Simplified README.md to focus on project overview and added a link to the getting started guide

Benefits

  • Cleaner README: The main README now provides a concise project overview without being cluttered with detailed setup instructions
  • Better organization: Development-specific documentation is now in a dedicated location that's easier to find and maintain
  • Improved onboarding: New developers can follow the getting started guide specifically designed for setup, while casual visitors can quickly understand the project from the README

Closes the issue requesting separation of development notes from the main README.

Original prompt

There are some Ad hoc notes and documentation at the bottom of the readme that is really only useful for development. Move this to a getting started.md file in the docs folder


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Copilot AI changed the title [WIP] There are some Ad hoc notes and documentation at the bottom of the readme that is really only useful for development. Move this to a getting started.md file in the docs folder Move development setup documentation from README to dedicated getting started guide Oct 3, 2025
Copilot finished work on behalf of BenjaminMichaelis October 3, 2025 10:09
@BenjaminMichaelis BenjaminMichaelis marked this pull request as ready for review October 3, 2025 10:11
Copilot AI review requested due to automatic review settings October 3, 2025 10:11
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR reorganizes the repository documentation by moving development-specific content from the main README.md to a new dedicated getting started guide for improved documentation structure and developer onboarding.

  • Created a new documentation structure with docs/ folder and comprehensive getting started guide
  • Simplified the main README to focus on project overview rather than detailed setup instructions
  • Improved organization of development environment setup information

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/getting-started.md New comprehensive development setup guide with prerequisites, startup steps, and environment configuration
README.md Simplified to focus on project overview with reference to getting started guide

@BenjaminMichaelis BenjaminMichaelis merged commit 10f90a2 into main Oct 4, 2025
9 checks passed
@BenjaminMichaelis BenjaminMichaelis deleted the copilot/fix-1451f9d3-afb5-4232-b302-a6add5e7d191 branch October 4, 2025 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants