Revision history [back]

Dear jolla team and managers,

I know you have many things to do, and you are really creative and productive. That's is not to criticize. That's great.

And there is a big part that i find that is something lost of sight. You can correct me if it's not. There is a lots of thing which are done, and not really documented. The user guide is for me currently not good enough.
I don't know for the 3d part interface for the developer part.

Documentation is the a and o by software developing.
software is nothing if it's not documented.

Everywhere i see that function x is integrated, every where i see different way to use it.
There is an app in harbour too or a gui from sfos, and it is pretty hard sometimes to have access on the info how to do it...
Because it is not in user guide, because there is many tjc threads that are no more relevant. We should make a lot of search, cross all infos with the version of each found topics.

for example I needed more than 2h to find how can i start tethering with which possibility (usb/bl/wifi) It awful!!

Please keep in mind that developing is not just programming, but take the documentation in charge too. By planning a new function or improvement, the dedicated documentation should be in timing calculation. I don't know if it's done in this way. And if not please that is really suggested.

Please after every release of functions take time to document it! at last the user guide.
I think more effort should be done, maybe more human resources.
This is really important, a good documentation make a good impression and make software clean!

If you want to maintain your update plan, and this request would disturb it.
You could make an Update plan a la Intel. A tic-tac update plan.
A tic with a lot of new or improved functionalities (user documentation updated) with major-bugfixes . And then a tac as just many bugfixes (documentation is just related to bug).

Thank you in advance for thinking about it.

Have a good sail

Dear jolla team and managers,

I know you have many things to do, and you are really creative and productive. That's is not to criticize. That's great.

And there is a big part that i find that is something lost of sight. You can correct me if it's not. There is a lots of thing which are done, and not really documented. The user guide is for me currently not good enough.
I don't know for the 3d part interface for the developer part.

Documentation is the a and o by software developing.
software is nothing if it's not documented.

Everywhere i see that function x is integrated, every where i see different way to use it.
There is an app in harbour too or a gui from sfos, and it is pretty hard sometimes to have access on the info how to do it...
Because it is not in user guide, because there is many tjc threads that are no more relevant. We should make a lot of search, cross all infos with the version of each found topics.

for example I needed more than 2h to find how can i start tethering with which possibility (usb/bl/wifi) It awful!!

Please keep in mind that developing is not just programming, but take the documentation in charge too. By planning a new function or improvement, the dedicated documentation should be in timing calculation. I don't know if it's done in this way. And if not please that is really suggested.

Please after every release of functions take time to document it! at last the user guide.
I think more effort should be done, maybe more human resources.
This is really important, a good documentation make a good impression and make software clean!

If you want to maintain your update plan, and this request would disturb it.
You could make an Update plan a la Intel. A tic-tac update plan.
A tic with a lot of new or improved functionalities (user documentation updated) with major-bugfixes . And then a tac as just many bugfixes (documentation is just related to bug).

Thank you in advance for thinking about it.

Have a good sail