Ubuntu Touch Programming Course
-
Good afternoon.
I wanted to comment on the status of the programming course. For personal reasons I have left the course on hold. In these moments with the day to day I already have enough.
I have reviewed the GitBook server and I see that several things have changed. Now the course is within the "legacy" subdomain and some functions like the start page have been disabled. The book can be updated but with several conditions:
- The book can only be in HTML format.
- Plugins no longer work.
For these reasons I am considering changing the platform of the course. It does not convince me to generate documentation only in HTML format. The platforms that I see reasonable are:
- LaTeX
- Sphynx.
- LibreOffice.
Of the three platforms I see more powerful LaTeX. It is true that it does more work than using Markdown + GitBook, but it also allows you to better adjust the output in all formats.
What is your opinion?
-
@mimecar hi, good to see you
Yes, LaTeX is more complete than the other two tools, and its output has the highest possible quality, but it has the steeper learning curve too, and that's not good if you want people helping you with your course, someday.
I personally don't see LibreOffice as a good option, so my opinion based in tool functionality, and user-friendliness, I think Sphynx is the best option
-
@mimecar Hello
I follow this forum since some months and I was really happy to discover your work (as I said above). There was a chance for me to develop GUI for usefull functions, which is my favorite hobby. I've been programming since the 80's with so many old langages, from microcode to object oriented. However, I don't know about collaborative methods of coding. It's difficult for me to involve in big projects. Nevertheless, I thought that your work could help me to be usefull for the community.
Unfortunately, I'm blocked (as described to youself and others above). I've read that I'm not the only one to have problems. So, mimecar, sorry but I've no idea about the questions you asked. But what I know is that it would be more usefull for the community to give your time in unblocking volunteers instead of improving your (really nice) documentation. Is it possible please ?
Best regards
Pulsar33 -
FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK
BR
-
@flohack wow, that would be really cool \o/
-
@flohack Thank you for the answer
I don't understand very well what is said on your link. Here is my lack of knowledge about collaborative methods of coding. I'm a poor lonesome coder ...
But if the work is about to succeed, it's a very good news !
Best regards
Pulsar33 -
@mimecar Hi...In my opinion, LaTex is the best option, easy and with sufficient resources to guarantee a comfortable edition.
-
@flohack Great...It would be great, it's very important for the Ubports ecosystem to have a SDK working without give us a lot of isssues.
-
@mimecar I know that everyone will have their opinion on your choice of technology, but I can say that document flow and downloadable formats are very good with Sphinx and ReStructuredText. At UBports, we mainly use Read the Docs to accomplish our documentation. The Godot game engine also uses Read the Docs for their documentation quite successfully.
If you have any questions on using any of these technologies, drop me a PM and I'll be happy to help you get them set up.
-
Good afternoon.
I have dedicated this week to analyzing the different options that I have. For the facilities that it gives, I will use ReadTheDocs. Although it does not give me as much control as the other options (LaTeX, LibreOffice, etc.), it allows me to fulfill the needs that I have:
- Reduced time since I finish an entry and it is published.
- To be able to have the course in several formats (HTML, PDF, etc.)
- Being able to have the documentation in several languages (facilitates collaborations)
- Integrated with version control.
I'm going to dedicate this month to migrate the course to ReadTheDocs. Next month there would be new delivery of the course. I still do not know if it will be at the beginning or at the end of the month.
-
@mimecar said in Ubuntu Touch Programming Course:
Next month there would be new delivery of the course.
This is great news! Thanks a lot!
-
Second version of the doc
https://pbs.twimg.com/media/DkP8fMjXgAE1m3J.jpg:large -
@mimecar looks great!
-
Hi @mimecar ! any news about your programming course? Do you need help on anything?
-
Hello,
@flohack said in Ubuntu Touch Programming Course:FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK
BR
It seems that something was done some days ago. Is the good sdk available now ?
Best regards
Pulsar33 -
@pulsar33 just in case you don't know it, @dobey is working on https://github.com/dobey/ergo
-
@advocatux : thanks but I don't find a thread speaking of that on this forum and github is a bit vague for me.
@Flohack : any news ?
Best regards
Pulsar33 -
@pulsar33 what I meant with that post is just to let you know that there will be a new toolkit
-
@flohack said in Ubuntu Touch Programming Course:
FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK
BR
@Flohack : I read on your link :
- Generate the SDK for Ubports #1
Merged
mardy merged 5 commits into ubports:master from mardy:ubports 21 days ago
But I'm not sure to understand. Can we use now the Ubuntu Touch Programming Course with the good sdk ?
Best regards
Pulsar33 - Generate the SDK for Ubports #1
-
