This will bump the version numbers due to significant amounts of fixes and updates relative to python 3 and the general ecosystem,

Kamaelia website is old. It predates the routine use of SSL and the recent enforcement of SSL (rather than "just" warnings) by chrome (etc) means that it it really needs updating to be over SSL.

There aren't any secrets or cookies or similar on the Kamaelia website so this hasn't been a priority, but it falls into the "really ought to get done" category. This may well happen as part of a change in hosting (which I've been mulling, since I'm footing the bill).

Now that the site breakage is fixed (as per #7 ) the site content needs updating. I'll create new issues for things I note here.

Key things that need changing

• New pre-release required
• Switch to semantic versioning rather than ubuntu style chronological. Last release was 1.0.12.0 I'll rebrand that as 1.12.0, since that seems to make a lot of sense. However, next actual release will be "2.12.1":
  • We always bump the patch number
  • The new release will not worry about backwards compatibility per se nor seek breakage, but 1.0.12.0 (and hence 1.12.0) was targeted at python 2 with some limited python 3 support. This release will drop python 2 support, and so fundamentally be a breaking update - hence the major version number change.
• References to sourceforge
• References to SVN
• References to CVS
• Examples that are on the website need to be runnable
• Examples that are in the repository that need work needs capturing

When this is done, the website content can be viewed as up to date.

The follow on work is to fix issues in the codebase.

A more critical short term issue is [ #14 ] - to enable SSL on the website, which is higher priority than content updates.

The markdown for the website will be able to be pulled into a public repo. When that markdown is in the public repo and updated, that will mark the completion of this issue. The tooling and markdown files will be updated to make this quicker/easier.

Recent is a time based thing and can be misleading "How recent is recent?" Latest always applies.

Currently only kamaelia.org is under SSL. www.kamaelia.org is hosted in the same place, but the cert isn't valid for it. That needs fixing.

This is a side effect of not upload Axon as a standalone package back in the day.
It is perhaps a better overall approach.

This ticket is to capture the fact this needs documenting

This is somewhat historical at this point, but a number of links on the kamaelia site are bust and the docs generation is currently non-functional. There's a lot of (now somewhat irrelevant) reasons for this, but it would be nice to fix.

One of the best ways of dealing with this is to redo the way the component generation takes place.

In particular -

Get Kamaelia Components to generate their own documentation. This would allow the website docs to be simpler. 95% of the work to do this already exists, but going the final step would probably be a good idea.

Also, this is doable because all the docs in kamaelia are written and intended to be machine readable in the first instance.
The only thing necessary to make that work is to ensure that importing a kamaelia modules does not do any work, and that instantiating a kamaelia object doesn’t do work. But it might be just sufficient to import the module rather than create instances.

Most of the internal docs are currently RST, but it would be nicer if they were markdown. This is akin to asking the classes and modules to generate a __str__ but suitable for external docs, so perhaps add a __markdown__ method (or function) to classes and modules ? That then allows a number of option and having some standard functions for generating aspects of API docs.

Quick test shows that the underlying library created to simplify working with vorbis still works as well today as it did 20 years ago, so the only thing that needs updating is the python (cython based - was pyrex based) bindings.
For example this works:

~/Development/kamaelia/Code/Python/Bindings/vorbissimple/libvorbissimple/src $ cat  ../../../../Kamaelia/Examples/SupportingMediaFiles/KDE_Startup_2.ogg | ./simple_decoder | aplay --rate=44100 --file-type raw --channels=2  --format=S16_LE -

Whereas this currently fails:

~/Development/kamaelia/Code/Python/Bindings/vorbissimple/python $ cat ../../../Kamaelia/Examples/SupportingMediaFiles/KDE_Startup_2.ogg| ./simple_decoder.py
Segmentation fault (core dumped)

In the grand scheme of things, I think this is pretty good.

What is the link to Guild, the successor of Kamaelia? (It's a rather common word, so not easy to be sure to find the correct one)