willcode2surf / ourumbraco

Our Umbraco

Complete source of the umbraco community site, our.umbraco.org.

Build in visual studio

Make sure to allow NuGet Package Restore in VS (Tools > Options > Package Manager). The first buid of the project will take quite a while, be patient, it will finish at some point. Upon build a web.config file will be copied into the OurUmbraco.Site project which you can use in the following step.

If you're working on the frontend (the js/css/etc parts in ~/OurUmbraco.Client) then you can either run ~/build/BuildClientFiles.bat to build them and have them copied into the site or ~/build/RunGulp.bat if you're actively working (gulp will monitor changes, build and copy). Or if you have npm/gulp installed on your machine you can run the usual commands in the ~/OurUmbraco.Client folder:

npm install
npm install -g install gulp -g
gulp

Database restore

Download the SQL Server Database from: http://umbracoreleases.blob.core.windows.net/ourumbraco/OurDev.zip

Restore the database to SQL Server 2012 SP2 (won't work on earlier version) and update the connection strings (umbracoDbDSN) in OurUmbraco.Site/web.config.

Logging in

All users and members use the same password: Not_A_Real_Password

To log in, try root / Not_A_Real_Password for the backoffice and [email protected] / Not_A_Real_Password for the frontend.

Projects Area

If the projects area seems empty then that's because you need to rebuild the Examine indexes for it through the Developer section of Umbraco

Documentation area

If the documentation area seems empty then that's because you need to download the documentation, look for the documentationIndexer in the Examine dashboard in the Developer section of Umbraco and Rebuild the index. This will automatically download the latest documentation from github.

Syncing your fork with the original repository

To sync your fork with this original one, you'll have to add the upstream url once:

git remote add upstream git://github.com/umbraco/OurUmbraco.git

And then each time you want to get the changes:

git fetch upstream
git rebase upstream/master

Yes, this is a scary command line operation, don't you love it?! :-D

(More info on how this works: http://robots.thoughtbot.com/post/5133345960/keeping-a-git-fork-updated)

Issues

If you're creating a pull request, make sure that it's backed by an issue on the tracker: http://issues.umbraco.org/issues?q=project%3A+our.umbraco.org

Mention the issue number in your pull request so we can merge it in more easily.

Even if you're not planning on sending a pull request, you can always create an issue on the tracker if it doesn't exist yet, it helps other find ways to contribute.