The new .NET Notts website written in Blazor. You can find the site at it's temporary domain name here;

https://dotnetnotts.azurewebsites.net/

• Contributing
• Local Development
  • Building Locally
  • Running Locally
  • Running Tests
• Build Tool
• Branding

Before contributing to this repository please follow the following steps. Also please check the contribution guidelines.

Before making any changes, check to see if there are any issues describing the feature you want to add or the bug you want to fix.

In the case that an issue doesn't exist for the change you want to make, raise one and fill in all the details asked for in the template.

When you have found an issue, comment on it requesting that you want to pick up the issue. If you have raised the issue, you can comment straight away saying you are going to resolve the issue yourself.

The reason for this is we have many people wanting to make certain changes, and we are running a first-come rota on who gets the issue. The first person to ask on an issue gets to resolve it.

If you can pick up an issue, the owners of the repository will comment saying so and set a in-progress label on the issue.

We are managing the demand to contribute by allowing the first person to request addressing a change on an issue to be the person whose PR we will review.

Some issues can have multiple contributions, so please do ask on the issue if you can still contribute.

There are many small changes available in the issues. This is to ensure there are plenty of issues available for different first time contributors to pick up.

Please don't address more than two issues in this repository.

The maintainers look after this repository in their free time outside of full time jobs. They also have other priorities and commitments. We will try to address issues and pull requests in a timely manner, but sometimes it will take a few days. Please be patient.

To build the project use the command dotnet build in the terminal of your choice.

To run the project locally use the command dotnet run in the terminal of your choice. This make the site available on http://localhost:5000/. Access that address in the browser of your choice to see your local version of the website.

To run tests use the command dotnet test in the terminal of your choice. If you wish to test code coverage, you can also run dotnet test --collect:"XPlat Code Coverage".

Existing test suites can be found under the ./tests folder. As of writing, the tests consist of only unit-level / component-level tests written using bUnit.

If you are editing or adding new components, please consider adding or updating tests to reflect your changes!

GitHub Actions is set up to build and run tests from Pull Requests so that we can ensure the project builds and tests pass from any changes made within branches before they are merged in.

GitHub Actions is also used to deploy on merge into master.

We ask that you make your changes to the front end with the following branding guidelines in mind:

• Green Background / White Text

  • Background: #05BD9E
  • Foreground: #FFFFFF

• White Background / Black Text

  • Background: #FFFFFF
  • Foreground: #000000

Font: Bahnschrift