Register a SA Forums Account here!
JOINING THE SA FORUMS WILL REMOVE THIS BIG AD, THE ANNOYING UNDERLINED ADS, AND STUPID INTERSTITIAL ADS!!!

You can: log in, read the tech support FAQ, or request your lost password. This dumb message (and those ads) will appear on every screen until you register! Get rid of this crap by registering your own SA Forums Account and joining roughly 150,000 Goons, for the one-time price of $9.95! We charge money because it costs us money per month for bills, and since we don't believe in showing ads to our users, we try to make the money back through forum registrations.
 
  • Post
  • Reply
Fatz
Jul 1, 2011
OctopusDeploy is a wonderful thing. Pretty much changed the way I look at deploying crap.

I hooked it in to TFS and Azure along with code metrics, code analysis and automated testing, etc. Everything starts as a gated checkin. If the code makes it through the 'gauntlet' it's automatically deployed.

One aggravating thing about OctopusDeploy. There's a utility exe called Octopack that wraps nuget.exe and produces an almost-nuget package. What gets created doesn't install correctly as a nuget in visual studio; only as a package in octopus deploy. OctopusDeploy uses Octopack for creating their deployment packages; not for creating nuget packages for consumption in other development projects--despite Octopack generating a .nupkg file.

Adbot
ADBOT LOVES YOU

Fatz
Jul 1, 2011
Just finished hooking up Sandcastle to our CI build because I'm a little tired of being asked for documentation that nobody uses.

If you're in the .NET world, Sandcastle has been around for ages. It's what MS uses/used for their MSDN documentation generation. Someone released the source to the public ages ago and I've been using it on and off since. It's been a good 5 years since I touched it last so I grabbed the latest last week. Really has come a long ways. Integrates into visual studio as a project type now. Just add a new "help" project to your solution, add the .*proj files as documentation sources and poof--instant docs...provided you've remarked your code everywhere.

Using Team Build (TFS) for building, I created a helper script that publishes the generated help after a successful build to a website and includes the url in the successful build notifications.

Fatz
Jul 1, 2011

..btt posted:

Interesting - I last looked at this about a year ago. Similarly, we are sometimes asked by higher-ups for standalone documentation no dev would use. At the time it was abandoned, hadn't been touched since 2012 or so.

Does it still have crazy build times? A fairly complex project that took about 10 minutes for our ancient build server to build would take in the order of an hour to build the docs, so it's been disabled since I set it up.

An hour? No, nothing that bad but there still is alot of overhead. The longest build I've got right now is about 2 minutes so it's tough for me to give reliable numbers, but sandcastle increased that one to 3 minutes. This seems to have caught on at my company and other teams are doing it now. Build times haven't been a complaint yet. My hunch is this will end up being for release compiles only or some other flag to turn it off.

Added bonus is watching the IIS logs and seeing of the people asking for documentation, how many actually use it.

  • 1
  • 2
  • 3
  • 4
  • 5
  • Post
  • Reply