Merged Master

This commit is contained in:
Graeme Christie 2014-06-03 17:40:46 +08:00
commit 5b6febecdc
4 changed files with 84 additions and 34 deletions

View File

@ -1,9 +1,34 @@
# How to contribute
One of the easiest ways to contribute is to participate in discussions and discuss issues. You can also contribute by submitting pull requests with code changes.
## General feedback and discussions?
Please start a discussion on the [Home repo issue tracker](https://github.com/aspnet/Home/issues).
## Bugs and feature requests?
Please log a new issue in the appropriate GitHub repo. Here are some of the most common repos:
* [DependencyInjection](https://github.com/aspnet/DependencyInjection)
* [EntityFramework](https://github.com/aspnet/EntityFramework)
* [Identity](https://github.com/aspnet/Identity)
* [KRuntime](https://github.com/aspnet/KRuntime)
* [MVC](https://github.com/aspnet/Mvc)
* [SignalR-Server](https://github.com/aspnet/SignalR-Server)
The full repo list is [here](https://github.com/aspnet).
## Other discussions
Our team members also monitor several other discussion forums:
* [ASP.NET vNext forum](http://forums.asp.net/1255.aspx/1?ASP+NET+vNext)
* [StackOverflow](http://stackoverflow.com/questions/tagged/asp.net-vnext) with the `asp.net-vnext` tag
* [JabbR chat room](https://jabbr.net/#/rooms/aspnetvnext) for real-time discussions with the community and the people who work on the project
## Filing issues ## Filing issues
The GitHub issue list is for bugs, not discussions. If you have a question or want to start a discussion you have several options:
- Post a question on [StackOverflow](http://stackoverflow.com/questions/tagged/asp.net-vnext)
- Start a discussion in our [ASP.NET vNext forum](http://forums.asp.net/1255.aspx/1?ASP+NET+vNext) or [JabbR chat room](https://jabbr.net/#/rooms/aspnetvnext)
When filing issues, please use our [bug filing templates](https://github.com/aspnet/Home/wiki/Functional-bug-template). When filing issues, please use our [bug filing templates](https://github.com/aspnet/Home/wiki/Functional-bug-template).
The best way to get your bug fixed is to be as detailed as you can be about the problem. The best way to get your bug fixed is to be as detailed as you can be about the problem.
Providing a minimal project with steps to reproduce the problem is ideal. Providing a minimal project with steps to reproduce the problem is ideal.
@ -18,6 +43,29 @@ Here are questions you can answer before you file a bug to make sure you're not
GitHub supports [markdown](http://github.github.com/github-flavored-markdown/), so when filing bugs make sure you check the formatting before clicking submit. GitHub supports [markdown](http://github.github.com/github-flavored-markdown/), so when filing bugs make sure you check the formatting before clicking submit.
## Contributing code and content
We are actively working to allow community code and content contributions. We can't accept code and content contributions yet, but check back soon for updates. ## Contributing code and content
You will need to sign a [Contributor License Agreement](https://cla.msopentech.com) before submitting your pull request. To complete the Contributor License Agreement (CLA), you will need to submit a request via the form and then electronically sign the Contributor License Agreement when you receive the email containing the link to the document. This needs to only be done once for any Microsoft Open Technologies OSS project.
Make sure you can build the code. Familiarize yourself with the project workflow and our coding conventions. If you don't know what a pull request is read this article: https://help.github.com/articles/using-pull-requests.
Before submitting a feature or substantial code contribution please discuss it with the team and ensure it follows the product roadmap. You might also read these two blogs posts on contributing code: [Open Source Contribution Etiquette](http://tirania.org/blog/archive/2010/Dec-31.html) by Miguel de Icaza and [Don't "Push" Your Pull Requests](http://www.igvita.com/2011/12/19/dont-push-your-pull-requests/) by Ilya Grigorik. Note that all code submissions will be rigorously reviewed and tested by the ASP.NET and Entity Framework teams, and only those that meet an extremely high bar for both quality and design/roadmap appropriateness will be merged into the source.
Here's a few things you should always do when making changes to the code base:
**Commit/Pull Request Format**
```
Summary of the changes (Less than 80 chars)
- Detail 1
- Detail 2
#bugnumber (in this specific format)
```
**Tests**
- Tests need to be provided for every bug/feature that is completed.
- Tests only need to be present for issues that need to be verified by QA (e.g. not tasks)
- If there is a scenario that is far too hard to test there does not need to be a test for it.
- "Too hard" is determined by the team as a whole.

View File

@ -4,6 +4,8 @@ In the next version of ASP.NET we are working with multiple teams around Microso
The Home repository is the starting point for people to learn about ASP.NET vNext, it contains samples and [documentation](https://github.com/aspnet/Home/wiki) to help folks get started and learn more about what we are doing. The Home repository is the starting point for people to learn about ASP.NET vNext, it contains samples and [documentation](https://github.com/aspnet/Home/wiki) to help folks get started and learn more about what we are doing.
These products are actively developed by the ASP.NET team assigned to the Microsoft Open Tech Hub and in collaboration with a community of open source developers. Together we are dedicated to creating the best possible platform for web development.
The samples provided are designed to show some of the features of the new framework as well as setting up a sandbox for you to try out some of the new features. The NuGet.config file in the repo points to a MyGet feed (https://www.myget.org/F/aspnetvnext/) that has all the packages being developed. The feed is updated every time a full build succeeds. The samples provided are designed to show some of the features of the new framework as well as setting up a sandbox for you to try out some of the new features. The NuGet.config file in the repo points to a MyGet feed (https://www.myget.org/F/aspnetvnext/) that has all the packages being developed. The feed is updated every time a full build succeeds.
@ -31,7 +33,7 @@ The first thing we need to do is setup the tools required to build and run an ap
* ```kvmsetup.cmd``` on Windows or * ```kvmsetup.cmd``` on Windows or
* ```sh kvmsetup.sh && source ~/.kre/kvm/kvm.sh``` on OSX/Linux * ```sh kvmsetup.sh && source ~/.kre/kvm/kvm.sh``` on OSX/Linux
* This command will setup your environment, getting it ready to install a version of the runtime. It adds kvm to your path and puts it in your user profile. * This command will setup your environment, getting it ready to install a version of the runtime. It adds kvm to your path and puts it in your user profile.
* Execute ```kvm install 0.1-alpha-build-0421```. This command will download the named version of the KRE and put it on your user profile ready to use. You can get the latest version by running ```kvm upgrade``` but 0421 was the last version explicitly tested. see the [KVM page](https://github.com/aspnet/Home/wiki/version-manager) for more information on KVM. * Execute ```kvm install 0.1-alpha-build-0446```. This command will download the named version of the KRE and put it on your user profile ready to use. You can get the latest version by running ```kvm upgrade``` but 0446 was the last version explicitly tested. see the [KVM page](https://github.com/aspnet/Home/wiki/version-manager) for more information on KVM.
* Navigate to samples\ConsoleApp * Navigate to samples\ConsoleApp
* Run ```kpm restore```. This downloads the System.Console package so the app can do Console.WriteLine * Run ```kpm restore```. This downloads the System.Console package so the app can do Console.WriteLine
* Run ```k run``` * Run ```k run```
@ -47,7 +49,7 @@ The first thing we need to do is setup the tools required to build and run an ap
git clone https://github.com/aspnet/Home.git git clone https://github.com/aspnet/Home.git
cd Home cd Home
kvmsetup kvmsetup
kvm install 0.1-alpha-build-0421 -p kvm install 0.1-alpha-build-0446 -p
cd samples\ConsoleApp cd samples\ConsoleApp
kpm restore kpm restore
@ -97,7 +99,7 @@ If you can do all of the above then everything should be working. You can try ou
By default when running the applications you are running against Desktop CLR (4.5), you can change that using the KVM command. By default when running the applications you are running against Desktop CLR (4.5), you can change that using the KVM command.
1. Run ```kvm install 0.1-alpha-build-0421 -svrc50``` This command gets the latest Core CLR version of the k runtime and sets it as your default. The -svrc50 switch tells it to use Core CLR, you can use -svr50 to target desktop again. 1. Run ```kvm install 0.1-alpha-build-0446 -svrc50``` This command gets the latest Core CLR version of the k runtime and sets it as your default. The -svrc50 switch tells it to use Core CLR, you can use -svr50 to target desktop again.
2. Run ```K web``` 2. Run ```K web```
3. The first line of your output should say "Loaded Module: klr.core45.dll" instead of "Loaded Module: klr.net45.dll" 3. The first line of your output should say "Loaded Module: klr.core45.dll" instead of "Loaded Module: klr.net45.dll"
4. The HelloWeb app should work the same as when running on Desktop CLR. 4. The HelloWeb app should work the same as when running on Desktop CLR.
@ -112,8 +114,8 @@ Currently the BCL is split into some fairly fine grained packages, which was one
# Known Issues # Known Issues
* Core CLR doesn't currently work on pre Windows 8 * Core CLR doesn't currently work on Windows OSes earlier than Windows 8
# Feedback # Feedback
You can log issues in this repo in order to start discussions, ask questions, make suggestions, etc. Check out the [contributing](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md) page to see the best places to log issues and start discussions.

View File

@ -1,10 +1,10 @@
{ {
"version": "0.1-alpha-*", "version": "0.1-alpha-*",
"dependencies": { "dependencies": {
"Microsoft.AspNet.Diagnostics": "0.1-alpha-build-0623", "Microsoft.AspNet.Diagnostics": "0.1-alpha-build-0682",
"Microsoft.AspNet.Hosting": "0.1-alpha-build-0519", "Microsoft.AspNet.Hosting": "0.1-alpha-build-0572",
"Microsoft.AspNet.Mvc": "0.1-alpha-build-1140", "Microsoft.AspNet.Mvc": "0.1-alpha-build-1268",
"Microsoft.AspNet.Server.WebListener": "0.1-alpha-build-0469" "Microsoft.AspNet.Server.WebListener": "0.1-alpha-build-0520"
}, },
"commands": { "commands": {
"web": "Microsoft.AspNet.Hosting server=Microsoft.AspNet.Server.WebListener server.urls=http://localhost:5001" "web": "Microsoft.AspNet.Hosting server=Microsoft.AspNet.Server.WebListener server.urls=http://localhost:5001"

View File

@ -1,10 +1,10 @@
{ {
"version": "0.1-alpha-*", "version": "0.1-alpha-*",
"dependencies": { "dependencies": {
"Microsoft.AspNet.Diagnostics": "0.1-alpha-build-0623", "Microsoft.AspNet.Diagnostics": "0.1-alpha-build-0682",
"Microsoft.AspNet.Hosting": "0.1-alpha-build-0519", "Microsoft.AspNet.Hosting": "0.1-alpha-build-0572",
"Microsoft.AspNet.Server.WebListener": "0.1-alpha-build-0469", "Microsoft.AspNet.Server.WebListener": "0.1-alpha-build-0520",
"Microsoft.AspNet.StaticFiles": "0.1-alpha-build-0402" "Microsoft.AspNet.StaticFiles": "0.1-alpha-build-0443"
}, },
"commands": { "commands": {
"web": "Microsoft.AspNet.Hosting server=Microsoft.AspNet.Server.WebListener server.urls=http://localhost:5001" "web": "Microsoft.AspNet.Hosting server=Microsoft.AspNet.Server.WebListener server.urls=http://localhost:5001"