Take the 2-minute tour ×
Programmers Stack Exchange is a question and answer site for professional programmers interested in conceptual questions about software development. It's 100% free, no registration required.

I work for a small company where I maintain a number of project all at once. I would like to create a blog and note software changes/update so that I can keep track of things. Plus it will also serve as help tool for other if they need help. I would like to install something locally on my machine or network, either ASP or PHP is fine. Which software would you recommend? Is it good idea, bad idea? Has anyone done it? I have worked with wordpress and I like it but I am afraid it is not best for code snippets. Any thoughts

I do use source control. I am not an expert on it though. I use three different development environment. 1. Visual Studio 2. Eclipse 3. SQL Server Management Studio

share|improve this question

closed as off-topic by MichaelT, GlenH7, Robert Harvey, david.pfx, Ampt Jul 22 at 15:47

This question appears to be off-topic. The users who voted to close gave this specific reason:

  • "Questions asking us to recommend a tool, library or favorite off-site resource are off-topic for Programmers as they tend to attract opinionated answers and spam. Instead, describe the problem and what has been done so far to solve it." – MichaelT, GlenH7, Robert Harvey, david.pfx, Ampt
If this question can be reworded to fit the rules in the help center, please edit the question.

3  
What do you use for source control? –  JohnFx Oct 4 '11 at 16:50

9 Answers 9

up vote 2 down vote accepted

If wordpress is what you know, I would stick with it. There are plugins available for handling code snippets, or you might just need some theming improvements.

share|improve this answer
    
+1 for plugins for markup. Wordpress is a good, free and easy start, but would move towards a bug/task tracker eventually –  SHug Oct 4 '11 at 16:11
    
I tried to use others suggested in answers esp funnerl but it required .net4. At least this is working for me for now. –  Noname Apr 10 '12 at 17:48

The traditional approach is to use a SCM like git, mercurial, or (if you have to) subversion, and wire it up against a ticket system. Combined with a bit of commit message discipline, that's all you need.

There are a few decent enough open source solutions; some of them also include a wiki, which is a perfect tool to write documentation collaboratively, as well as working out stuff that doesn't quite fit the ticket data model yet. With a bit of extra effort, you can expose the wiki to a greater audience, read-only.

I can imagine a blog adding extra value, such as being able to write about your development workflow, but not to implement it. Wordpress should be perfectly suitable; see if you can find a nice code formatting plugin (if you have to, there's an excellent javascript syntax highlighter floating around, it's easy enough to use and non-obtrusive, so it should work just fine with any blogging software you can imagine).

share|improve this answer
    
I am the only developer. No one else knows what is going on. It would benefit me foremost as the changes are quite a bit and hard to keep track of and sometimes you do mess with things you dont remember later :( I use subversion for all my code. –  Noname Oct 4 '11 at 15:49
    
+1 for ticket system / bug tracker. Makes it much easier to see the changes between each release. Jira / Confluence works well –  SHug Oct 4 '11 at 16:09

Have a look at redmine. It combines:

  • Ticket system with project management
  • subversion integration with repository browser
  • Wiki - document your projects here
  • Document management
  • News (aka blog)
  • Forums

Various plugins exists, programmable in ruby-on-rails.

Subversion integration is really cool. When you commit with the comment 'Related issue #127 - Crash at file open', it will associate the revision to the issue. If the comment contains 'fixes #127' it will mark the issue as fixed (configurable).

share|improve this answer
    
+1, for ease of use check out the pre-rolled appliances at turnkeylinux.com . –  Wyatt Barnett Oct 5 '11 at 0:30
    
would like to point out, we dont use bug tracking system. Everything is verbal. –  Noname Oct 5 '11 at 13:34
    
@Dave: This is a good opportunity to implement one. –  Steve Evers Oct 5 '11 at 15:14

You may wish to take a look at FunnelWeb (http://www.funnelweblog.com/). They advertise themselves as "a blog by developers,, for developers", and it contains good support for source code highlighting. In fact, I believe it uses the same format as Stack Overflow for the markup.

It is ASP.NET based though, which may be an issue for some.

I have been planning to deploy it on my site, but have yet to fully do so. I personally felt that Wordpress was too bloated for my needs, and so decided upon FunnelWeb.

share|improve this answer
    
funnel would exactly suffice my neads, installing is just a bit of work. –  Noname Oct 4 '11 at 21:24
    
I can not get it installed with these instructions. funnelweblog.com/getting-started –  Noname Oct 5 '11 at 13:18

In our company we've used Pebble successfully. The main advantages are that it is very lightweight (pure XML), does not need a database and is very easy to install. It's based on J2EE so you may install it on Tomcat for example. Here is the description you can find on the website:

Pebble is a lightweight, open source, Java EE blogging tool. It's small, fast and feature-rich with unrivalled ease of installation and use. Blog content is stored as XML files on disk and served up dynamically, so there's no need to install a database. All maintenance and administration can be performed through your web browser.

Now, if Wordpress is all you know at the moment and whether you want to use Wordpress or Pebble, or anything else for that matter, you should know that you can always add SyntaxHighlighter to your blog engine. It is a code-syntax highlighter based on Javascript and supports many different "brushes" (languages). You can even easily add your own syntax.

For what is worth, I've added SyntaxHighlighter both to Pebble and JamWiki (a J2EE Wiki)

EDIT: If you are using or planning to use JIRA, you definitely should take a look at Confluence which nicely integrates JIRA and is a "big" CMS/wiki/blog.

share|improve this answer

If you have good internet connectivity where you are, you might want to flee to the cloud, so to speak -- offload things onto software services. There are a number of options out there, but if I had to pick one I would probably go with bitbucket.org for a few reasons:

  • They are free for small scale -- IIRC, 5 user private repositories are still free, group plans are much cheaper than github.
  • More windows-friendly than the main alternative due to mercurial. TortiseHG is arguably better than tortiseSVN.
  • Now also supports git if you want it/need it [like when I need to do iOS projects and I don't want to force people to fight xcode to use hg]
  • Fairly straightforward to administer.
  • Don't have pictures of cartoon cats everywhere. Ok, that might be personal.

If you want to stay on campus, redmine as suggested by aquaherd is a pretty decent option. The the virtual appliance makes it a ludicrously easy option. Just remember the backups.

share|improve this answer

There are a few open source solutions.It is hard to beat WordPress for general personal blogging. WordPress is an open source, state-of-the-art personal publishing platform.This post provide a good information about software. I appreciate to this one.Thanks to share this blog with us. Keep it up.

share|improve this answer

We've used changelog (while building debian packages) for this purposes. It was pretty informative, since the same changelog was used by testers, ant they always should know, what's knew since last deploy.

So, we have a changelog, on each build automated mail has been sended and there was also internal RSS feed, but nobody used it, actually.

share|improve this answer

If you are wanting to keep your users in the company up to date, your best bet is to email them. Thy won't periodically go your blog and read it - you need to condense the most important information for each user group and weekly (maybe monthy) send out an email. that way they can ask questions and be more likely to read it.

Maintaining a blog for your own notes is a good idea too, but that's going to be a technical resource. I assume your users are not technical. Aim the level of information to be what they need to know.

share|improve this answer
1  
I think you missed the point. It is about software changes and maintaining the code, not for employees. I have started wordpress blog for now though and it is working good. –  Noname Mar 30 '12 at 14:06

Not the answer you're looking for? Browse other questions tagged or ask your own question.