Developer Documentation

bhdouglass · 1 Oct 2018, 19:27

Hello fellow developers!

The UBports App Dev Steering committee has recently started efforts to improve the app developer documentation. The improvements are not just geared at onboarding new developers, but they are also for experienced developers. The first step in this long journey was the publishing of a revamped app dev page in the UBports docs. But there are several holes in it still! We've identified several areas where a tutorial would be useful and created a project in GitLab to track them. If you are interested in creating documentation/tutorials check out the project on GitLab and/or join our UBAD Discussion Group on matrix.

We want to make Ubuntu Touch the best development platform out there! We appreciate your help and support!

fulvio · 2 Oct 2018, 09:01

Hi @bhdouglass ,
juts to don't have some duplicated contents, some time ago I have written two chapters with samples for QML course of mimecar:

"Database access with QML"
text: https://mimecar.gitbooks.io/ubuntu-touch-programming-course/content/en/chapter-05-s01.html
Sample source: https://github.com/mimecar/ubuntu-touch-programming-course-src/tree/master/WeatherRecorder
"QML and Charts"
text: https://mimecar.gitbooks.io/ubuntu-touch-programming-course/content/en/chapter-05-s02.html
Sample cource: https://github.com/mimecar/ubuntu-touch-programming-course-src/tree/master/WeatherRecorderChart

If you want fork them and/or move to your new documentation portal for me there are no problems, but please ask before
at @mimecar if agree (i have only written that chapters but he is the maintainer/owner of the course).
Tnx

bhdouglass · 2 Oct 2018, 19:01

@fulvio awesome stuff! I believe @mimecar is converting the course to another format, so I'll let him decide if he wants to integrate it into docs.ubports.com.

shelllavie · 3 Oct 2018, 11:49

This post is deleted!

mimecar · 7 Oct 2018, 19:43

Goodnight

Time passes and I do not have time to finish the migration to Sphinx. For now I will continue with GitBook (with the new version). Later I'll make the migration to Sphinx.

poVoq · 2 Dec 2019, 10:54

Is the matrix chat group active? Any chance to get it bridged to an IRC channel on Freenode?

AppLee · 2 Dec 2019, 11:09

@poVoq Yes matrix chat group is bridged with Telegram APP Development group and active.

poVoq · 2 Dec 2019, 11:36

@AppLee could it also be bridged to IRC? I use neither Matrix nor Telegram

Also the telegram to #ubports on freenode bridge seems down atm.

AppLee · 2 Dec 2019, 13:17

@poVoq It is probably doable, but I don't know who can...

lsitongia · 4 Jan 2023, 22:29

I'm taking another run at learning to work on apps. Central to this is the developer documentation.

Right away, the first link is bad. @mimecar course goes to
https://docs.innerzaurus.com/
which doesn't work.

I know that there's a Github site for the Gitbook, but I don't think a person getting started should have to learn about how to work with that in order to learn the programming part of it. At least, not at first.

I think I've found an HTML version of the course. I don't know if that is current. If it isn't, I think there should be a live version of the built Gitbook as HTML in docs.ubports.com.

I'm willing to work on the documentation to make small changes such as what might be helpful in this case. I've gone through the process once before, on the Pixel 3a documentation in Github.

I'd like the Developer Guides to be the one stop for everything I need to learn to make progress here.

Thank you.

mimecar · 9 Jan 2023, 18:01

Good afternoon @lsitongia . There is an error on the URL (on DNS side). I think I will be able to fix it on weekend. I can give you the link to the source code.

mimecar · 28 Jan 2023, 12:22

Good afternoon.

Sorry for taking so long to fix it. The last few weeks I have been quite busy and I have not been able to dedicate time to projects. There was a problem with the DNS and it's fixed now. The link to the course should work fine.