KorsG

Whether you're trying to give back to the open source community or collaborating on your own projects, knowing how to properly fork and generate pull requests is essential. Unfortunately, it's quite easy to make mistakes or not know what you should do when you're initially learning the process. I know that I certainly had considerable initial trouble with it, and I found a lot of the information on GitHub and around the internet to be rather piecemeal and incomplete - part of the process described here, another there, common hangups in a different place, and so on.

In an attempt to coallate this information for myself and others, this short tutorial is what I've found to be fairly standard procedure for creating a fork, doing your work, issuing a pull request, and merging that pull request back into the original project.

Creating a Fork

Just head over to the GitHub page and click the "Fork" button. It's just that simple. Once you've done that, you can use your favorite git client to clone your repo or j

	//Snippet from Program.cs which adds the provider and sets up a Settings class to map the settings

	using ErikNoren.Configuration;
	using TestMvcWebApplication;

	var builder = WebApplication.CreateBuilder(args);
	builder.Configuration.AddSqlDatabase(config =>
	{
	//We can get the connection string from previously added ConfigurationProviders to use in setting this up
	config.ConnectionString = builder.Configuration.GetConnectionString("DemoDatabase");

	// Zero-Clause BSD (more permissive than MIT, doesn't require copyright notice)
	//
	// Permission to use, copy, modify, and/or distribute this software for any purpose
	// with or without fee is hereby granted.
	//
	// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
	// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
	// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
	// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
	// OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER

	// Zero-Clause BSD (more permissive than MIT, doesn't require copyright notice)
	//
	// Permission to use, copy, modify, and/or distribute this software for any purpose
	// with or without fee is hereby granted.
	//
	// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
	// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
	// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
	// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
	// OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER

	using System;
	using System.Diagnostics;
	using System.Numerics;

	#if NETCOREAPP2_1_OR_GREATER
	using System.Buffers.Binary;
	#endif

	#nullable enable