Although it wasn't difficult, I had expected to find more detailed instructions on the site; particularly for those not familiar
with all the different source control client options.
To help others, I took a diary of screenshots along the way. The project itself - searcharoo.codeplex.com
will be available soon...
 |
First step was figuring out where to 'start' adding a new project... the link appears once you have logged in |
 |
Create New Project (1 of 3)
Setup your project info |
 |
Create New Project (2 of 3)
Terms & Conditions, and CAPTCHA test |
 |
Create New Project (3 of 3)
Terms & Conditions, and CAPTCHA test |
 |
Now you have an empty project page
Choose which version control client you wish to use (the connection details on the right change accordingly).
I'm assuming that you can find, download and install one of these options - I chose the Visual Studio Team Explorer.
The Visual Studio Team Explorer wiki page
wasn't particularly helpful, hence my motivation for writing this page. |
 |
Given the connection information displayed on our empty project page, we can now add our project to CodePlex.
Here you can see the Source Control menu in Visual Studio 2008, added by the Visual Studio Team Explorer client.
I am choosing the Add Solution to Source Control... option, because the Searcharoo solution is already open and ready to upload. |
 |
Connecting to CodePlex (1 of 8)
The first thing we see is an empty dialog: press the Servers... button to connect |
 |
Connecting to CodePlex (2 of 8)
Another empty dialog: press the Add... button |
 |
Connecting to CodePlex (3 of 8)
Hooray - now it asks for the server name, port number and protocol (CodePlex showed these on the project page) |
 |
Connecting to CodePlex (4 of 8)
Connecting to the specified server requires authentication.
This is where we need the login credentials displayed on the project page. |
 |
Connecting to CodePlex (5 of 8)
Return to the server list, but now there is a server to select, and press Close. |
 |
Connecting to CodePlex (6 of 8)
Visual Studio Team Explorer has retrieved the name of your project from CodePlex (I guess some people might have more than one,
but they probably aren't going to need these instructions).
Check your project and press OK. |
 |
Connecting to CodePlex (7 of 8)
Now choose your solution folder name - I didn't want it to be exactly the same,
so I called it SearcharooSolution and pressed OK. |
 |
Connecting to CodePlex (8 of 8)
Pressing Advanced... on the previous window just shows the paths to all the individual projects in your solution. |
 |
Checking in to CodePlex (1 of 3)
Now the Add to Source Controlprocess is complete and we are returned to Visual Studio -
however all we haven't checked-in yet!
Notice that the Pending Changes window contains all our files, and the Solution Explorer has a little + plus
sign next to each file, indicating that it's ready to be checked-in. |
.png) |
Checking in to CodePlex (2 of 3)
Type a comment and press Check In - a progress bar appears to show your files being sent up to CodePlex!
It actually seemed to be quite fast. |
 |
Checking in to CodePlex (3 of 3) - DONE
The Solution Explorer now shows the status of all the files as checked-in. |
 |
Back on CodePlex, the code we just checked-in is now visible - and ready for people to download and play with.
Of course, it's nice to also add stable versions as downloadable ZIP files under the Releases tab,
set a license in the License tag and generally monitor the Discussions and Issue Tracker... but
MOST IMPORTANTLY don't forget to press Publish This Project before your setup period expires! |