Please review New added FAQ

webratte 2017-04-09 05:47:57 UTC #1

I just added a new FAQ (Is it possible to use a pre-existing XMPP/Jabber account of the form username@jabberservice.com with Kontalk clients?)
Maybe someone want review it.

I also added a link from/to desktopclient help page to android help page into the side bar.

@abika I think we should the desktopclient help page split into more pages (FAQ,developement and so on) like for android clent. What do you think?

I can do that in smal steps from time to time

daniele_athome 2017-04-10 12:17:04 UTC #2

Thanks @webratte, the new question for Android is perfect.

I'll leave to @abika the review of the desktop client wiki, but they seem good to me as well. And the idea of doing a more complex article structure also for the deskop client wiki is great, also subjected to @abika approval: I believe more structured and regulated projects are more likely to attract developers.

webratte 2017-04-10 17:38:03 UTC #3

Since @abika not answered yet I will start the desktop client wiki structure adapt to the android client wiki in hope he will like it

abika 2017-04-10 18:56:46 UTC #4

Oh, thanks for the effort! I will reply within the next days when I have more time.

webratte 2017-04-10 19:12:38 UTC #5

Hi @abika no hurry,
I have just did a few things with the desktopclient wiki.
Maybe you want take a look on it if you have time.

I think we also should build a single page for "Development" linked in the sidebar.
But in this case on the homepage will be nomore information

If you like you can write a few words about the desktopclient or some what.

webratte 2017-04-10 19:37:57 UTC #6

Hi @abika Hi @daniele_athome,

Hi have just played around.
The FAQ page will grow up I think.

And I have just made a draft for a redsign.

What do you think?

daniele_athome 2017-04-13 09:44:08 UTC #7

Nice touch with the list of questions, thanks
I've fixed a couple of syntax errors, but for the rest is ok. Also please remember to always use relative links where possible instead of hard-coding the whole URL. For example:

* [What is the personal key?](#what-is-the-personal-key)

That's not possible every time, but please try and then use the full URL only when absolutely necessary.

You can apply the modifications on "Testpage" to the official FAQ page (can you do it for other languages as well?)

Thank you!

webratte 2017-04-14 05:28:07 UTC #8

Thank you,
you absolutely right. Relativ links always the better solution.

And of course I will adapt all FAQ pages step by step if I have time.
I will start with the english version.

webratte 2017-04-14 12:29:02 UTC #9

Done.

Now we just need some more translations

abika 2017-04-27 14:46:31 UTC #10

Thanks @webratte!
I moved the development FAQs to a new page, too.
+ Updated FAQs a bit (with one new question).

If you have ideas for more information...
Otherwise it's fine that way imo.

About the new FAQ questions:

Phone numbers are not stored because we use hashes of them throughout the network.

Please remove this sentence. We know its not true.

abika 2017-04-27 14:49:40 UTC #11

Yes, thats true. But I think it's more the reason of not having many users in this case.

webratte 2017-04-27 16:00:15 UTC #12

What's wrong on this sentence? AFAIK there are only Hashes stored. I think @daniele_athome anwered this (old) question

But I know what you mean Hashes of Phonenumbers not really secure.

@abika you know much more about this tecnical things. Maybe you can find a better description.

If not, feel free to remove this sentence on your own

About the Homepage of the desktop wiki.
I also think it's fine.

I will to the Developers FAQ also add a linked question list like on the "normal" FAQ page as soon as possible.
Thank you

abika 2017-04-27 21:15:46 UTC #13

Phone numbers and hashes are basically the same thing in different representations (unfortunately).
So the sentence is just wrong. We have to remove it. I'll do it.

webratte 2017-04-28 04:23:05 UTC #14

OK, thank you.
But in this case we should not to suppress this fact.

Because the question is:

Will you store any personal data on server?

What abaout something like:

Your phone number is your username. We have to store your (hashed) phone number to find other registered users.

abika 2017-04-29 15:27:17 UTC #15

It's not only used to find other users. The (hashed) phone number is also your JID (=Kontalk address). It's everywhere: in every message, public key and saved on server.
And "normal" people don't know what a hash is. We may have to explain it(?). I don't really know what's the best thing to write here is.

webratte 2017-04-29 16:04:41 UTC #16

What about to explain it like:
Your (hashed) -Linked to a Wikipedia article - phone number works similar to a email adress. Every message need to be adressed to find the receiver and to know who is the sender.
The same for Pub key. There have to be also a adress to know it's your key wich it's used for encryption.

And of course a list of all Kontalk users (only there hashed phone numbers and niknames) to find other users.

This is a only draft in Bad english
But maybe a Basis to work with it.

webratte 2017-05-12 13:30:23 UTC #17

@abika What do you think about this?

abika 2017-05-12 17:46:23 UTC #18

The link to Wikipedia is a good idea. But the way your wrote it, it's still not exactly true.

Well, yes. But does not have to be the (hashed) phone number. This is all about https://github.com/kontalk/androidclient/issues/497. It would be honest to write:

Your [link]hashed[/link] phone number is publicly visible throughout the network.

webratte 2017-05-12 18:26:34 UTC #19

I would like to mention phone number = user name.
What about this:

Your user name (your [link]hashed[/link] phone number) is publicly visible throughout the network.

Honesty is always a good idea

abika 2017-05-13 16:54:51 UTC #20

Why user name? It's your Kontalk address.