Creating welcome pages on VSO made easy with Markdown files

In of the recent updates on Visual Studio Online a very nice feature was introduced. Welcome pages.

When you want to share some information about you project or other information with your team, what is the place to do that? When working on-premise you maybe have a SharePoint portal or a corporate blog, but when working with VSO there is not really a location that makes sense.

This changes in the update of August 18 2014. Welcome pages are introduced and it is really easy to use! Welcome pages use the Markdown language to let you easily create some documentation for your team. You can find a nice post about this feature here.

The welcome page can be found when you enter the Team Project on VSO, and when you click the [Welcome] Tab

image

At first it will probably show nothing. This is because a .Readme.md file is needed in the root of you source control.

Create a Readme.md (for example using Markdownpad) and check this in to the root of your Team Project. Once there, you will see the home page appear.

You can have more markdown files in your project so you can built up a whole tree of documentation!

Tip!

Currently there is no “nice” way to link link files relatively. In order to link to another file, just click the file on the welcome tab, and copy the last part of the url.

Use this in your Markdown.

image

Advertisements

No comments yet... Be the first to leave a reply!

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: