The Good Suite


Version 0.4.0 released

9 Feburary 2015

It's here: The Good Suite v0.4.0. We're still on o.x.y and as SemVer dictates, this means everything and anything is still subject to change. There's still no documentation, but it definitely feels like the software is inching towards usability. The APIs have no more planned changes and seem to be mostly stable.

This release focussed on the datatype file format, which underwent some major changes. It looks better now though, and is more powerful as well. The full details and downloads can be found on the download page.

The future of The Good Suite seems to be full of possibilities. The next release will focus on making the functionality that's already there more usable and available. It is also scheduled to finally include that elusive documentation...

This site now uses Good Looking

31 July 2014

It's common practice that if you make something you can make a website or a part of a website with, the tool's website is made with that tool itself. After all, if the creator of the tool doesn't use it, how can he or she advocate other to use it?

The Good Suite has long escaped this practice. Of course, I'm not yet advocating for people to use it, so it's sort of okey. However, it was still something that I was aiming for. With version 0.3 of the Good Suite, the Good Looking API has become more or less stable and server side includes have been added - which was the main feature required to eliminate much of the duplication that was present in the static html version of this website. As such, this website was moved over to using Good Looking.

In fact, the move happened shortly after version 0.3 was released and most people will probably have noticed it. The only change to humans is that the file extensions have changed from .html to .php (it's better practice not to have either, but I'll leave that for some point in the future). The fact that I haven't found the time to write this until now is actually rather\ ironic, considering that this update made it much easier for me to add new news items to this website.

Of course, this website ought to use the entire Good Suite eventually, but that will be left for when the different APIs get more stable. For now, this is just a big step forward and it should be considered as such.

Version 0.3.0 released

25 May 2014

Today, version 0.3.0 is released. It's still no cakewalk to use it and as a SemVer 0.something version, everything is stil subject to change. However, though documentation is still lacking, the public APIs are moving towards stabilty at a high speed.

The main feature of this version is the addition of function -- and in particular include -- to GoodLooking. This is something that had been in the planning for a long time now and it was in fact a hurdle towards adoption even by myself. After all, what's the added value of a system like this if you can't include files? Previously, even I was better off using either static html or full php. No longer, as this functionality has now arrived.

On the the download page you can find the download and read the exact changelog.

Roadmap for versions 0.3 through 0.5

1 June 2014

While it's still unsure when I'll be abkle to find how much time to work on this, there is now a general roadmap, that describes which features will be in which version. The upcoming version is basically set in stone, while the last version may still change a lot. That said, this is what is planned at this moment.

Version 0.3 will be a small release, adding only a couple of features. Two fo these features will be the addition of variable assignment to the Good Looking templating language and a major stabilization of the Good Service generated classes through having both properties and getters/setters and having protected fields actually be protected. The third and last change is that we're finally adding functions to the Good Looking templating language. The lack of functions has been a major roadblock for adoption even by me for things like this website, as being able to include another file is at the core of any server-side processing. Now, this will be possible and I would expect this website to actually start using GoodLooking.

The version after that, version 0.4, will focus on changing the datatype file format. A number of changes to this fyle format are planned, including at least one that will break backwards compatibility. Getting this out of the way brings us a lot closer to a stable API.

The last version that is planned is version 0.5. The idea is that it will not focus on adding new things, but instead focus on making the current things usable. This means that documentation should be written, it should be possible to use the different modules without needing a couple dozen lines of code just to make sure that everything starts up correctly and that should become painless to install The Good Suite.

Version 0.2.0 released

25 May 2014

Finally, the second version of this software has been released. It's still rather hard to use, has no documentation and features unstable APIs, but that's why it's an "0." version (we're using SemVer after all). It can be found on the the download page.

In fact, there have not been any changes to this code for a while now. Having periods without any work on this project is not a new thing, but not releasing a version at the moment it was done is. The reason for this situation is that there was another planned feature, which was open for a long time, until finally it was decided to solve the underlying problem in a different way, and that feature was scrapped. This meant that all features for v0.2 were now done and it could be released.

Version 0.1.0 released

15 August 2013

Today, the very first version of The Good Suite is launched. It is called version 0.1.0 and it can be found here (there's a direct download as well as a link to the tag on github.

In accordance with the rules of Semantic Versioning this is a pre-release version with an unstable public API. This is very much the case still, and is the reason why I can't really recommend anyone to use The Good Suite just yet. On top of that, there are no documents detailing usage or the public API yet, so for both the only resource at the moment is the tests (which are not in the direct download, but can be found on github.

The Good Suite adopts Semantic Versioning

13 August 2013

I recently found out about a thing called Semantic Versioning or semver. It's a description of when and how a version number should be incremented and can be found at

I wasn't previously aware of such a system and had been thinking about writing my own set of rules. However, while reinventing the wheel is sort of a hobby on mine, I decided to pass on this one and use semver instead. This will mean people have a better idea of what the version numbers mean and assures good interoperation with things like composer.

Since no version has been released yet, the practical consequences are few. However, the fact that Semantic Versioning has clear rules about how you can alays break backwards compatility as long as you're working on version 0.x.y does stimulate actually releasing early on with zero point something versioning. Originally, the plan was to release a first version when the API was nearing stability at the earliest. Now, though, this plan has changed to one where we start handing out version numbers much sooner and one should expect version 0.1.0 to be released in the near future.

Version 0.1 will be released as a single bundling of the entrie Good Suite. This does not mean that this will be the form in which all future releases will be. How they will be done has simply not been decided upon yet. The liberty semver gives me before reaching version 1.0.0, though, includes not letting that stop me from releasing early and just stating that it may change.

This website was launched

11 February 2013

The website you are looking at is up running.