#qlovaseed

Video I created to get people interested in Qlovaseed and Zapp frameworks. The video also briefly explains what the two frameworks are about.

Gathering feedback on what had been created so far in Feedback on Videos (Hedges, 2019), and on other marketing videos in Reviewing Company Videos (Hedges, 2019) showed that by having a shorter video length or using abstract visuals made the videos more interesting.

The colours brown and blue that I used were based off of Shigenobu’s Color Image Scale colour palettes. I recommend the book if you are looking for colours with a bit of meaning behind the choice.

Hedges, B. (2019, July 29). Feedback on Videos [Google Sheet] Retrieved from bit.ly/35CJ8Xc

Hedges, B. (2019, July 29). Need an App? [Video file]. Retrieved from https://www.youtube.com/watch?v=k0lYeqQnN08

Hedges, B. (2019, Oct 13). Reviewing Company Videos (Responses) [Google sheet] Retrieved from bit.ly/2VJGpXm

Yesterday, the Qlovaseed documentation was tested for the first time (Qlovaseed is an app-development framework I am working on). Completely unprompted, my girlfriend tried using the framework and stumbled right into an issue. She couldn’t display an image in an app she created.

To add an image to an app, you need to have it in an ‘assets’ directory inside your project.

image.AddTo(App, "image.png") //This loads the image ./assets/image.png

The fact that this issue came up, clearly shows that the current documentation is inadequate (There are plenty of other undocumented features of the framework).  Software frameworks that are written in Go (and hosted on GitHub) have their documentation automatically generated on godoc.org. Sourced from comments made by the developer within the code. For large projects though, Godoc has some pretty apparent weaknesses. Take a look at the GitHub API documentation:

Currently, Qlovaseed is using Godoc and while it may be great as a quick API reference. An app-development framework needs something better. Perhaps Sphinx, which I discovered because it powers the documentation for the Godot game engine (which I have been impressed by before).

Sphinx offers free documentation hosting for open-source projects and allows documentation to be written for a project in a custom format. I am currently investigating Spinx along with my team to establish whether or not it is a good choice for the Qlovaseed documentation.

I took the plunge and decided to announce Qlovaseed on Reddit. To prepare for this, I added a license to the project, created a website and updated the Readme for the project on Github so that people knew how to install and use the project.

I posted it on the /r/golang subreddit, as this community is familiar with the programming language Go and are the most likely set of people who would understand the project and find it useful.

This stirred up a controversy straight away, one user requested me to update the title because calling it an app-development framework is misleading. This is harsh. They are trying to say that ‘webapps’ are not apps.