Loomio

Add help page

SVB Steffen van Bergerem Public Seen by 79

I think we should add a 'help' link to the right dropdown menu in the header showing a 'help' page on the pod. Once the page has been set up we could get a lot of newcomer devs to work on user manuals and translate them. (I think it is very important for new users that they can read the user manuals in their chosen language) A draft could be the wiki page FAQ for Users.

I am not able to create this page but I will be happy to work on manuals or translations.

SVB

Steffen van Bergerem Thu 15 Aug 2013 5:30PM

Sounds reasonable. I just have to disagree in one point: I think that we should also help signing up. The help pages are visible to everyone (not only signed up users) so we could add a link to the sign-up page.

F

Flaburgan Fri 16 Aug 2013 12:09PM

Oh men, I agree with you both... @steffenvanbergerem your 3 points are perfect. @goob the sign up tutorial is cleary better placed on diasporafoundation than on a pod...

So yeah, I think we should have a help page on diaspora itself, but only about the most asked questions. A FAQ is perfect. Besides, tutorials explain "how-to", not always "why". The explanation of the 3 "bugs" I pointed in my article explaining the federation surely should be present in diaspora* itself. But only with a very short sentence. After that, we're free to add a link to tutorials, blogs, everywhere there are explanations.

G

goob Fri 16 Aug 2013 1:04PM

Would https://wiki.diasporafoundation.org/FAQ_for_users be a good starting point for this?

SVB

Steffen van Bergerem Sun 18 Aug 2013 7:34PM

I used FAQ for Users so it would be nice if some of you could help reading it again, correct errors and add missing things. If there is anything which should be on the help page but not in the FAQ or vice versa I'd be open for suggestions.

I left out "Is there a directory that lists public pods (servers) that I can join? " and "How can I join Diaspora?". I also changed the answer to "Where else can I get support?" because I wanted to link to the upcoming official tutorials instead of diasporial.

If anyone wants to check out the code: you can do that on github

SVB

Steffen van Bergerem Tue 20 Aug 2013 10:39AM

@goob Are your tutorials going to be online on diasporafoundation.org for the next release? Do you already know some URL where I will find those? I added some links on the help pages and linked to the tutorial main page and to the formatting tutorial (and will have to change those links)

G

goob Tue 20 Aug 2013 1:19PM

@steffenvanbergerem I've finished my work on the tutorials pages, and am trying to commit them right now. Having a bit of trouble. But they should be on Github by the end of today, all being well.

On the diasporafoundationdomain, the main tutorials menu will be at /tutorials and the formatting one at /formatting (original, eh?).

G

goob Tue 20 Aug 2013 1:55PM

Now on Github - PR here.

F

Flaburgan Wed 21 Aug 2013 8:36AM

Hi guys, about the tips @goob talked, I think the content of the right side bar should be moved to a tips page inside diaspora* (follow #newHere, need help, bookmarklet...) everything is not needed on the main page.

F

Flaburgan Thu 12 Sep 2013 11:11PM

We merged translations in develop today and I started reviewing the french one. I think many sentences in english are not clear, so translators often made mistakes. A FAQ is for newbies, we have to improve it, make it as concise and simple as we can.

There is also a place for other improvements than formulation. For example, pod is the fifth element in the left menu, but we talk about it a lot in the previous element. A newbie is going to think "what's the hell is a pod?". We should think about the order of the concepts.

Last idea, only about design: the other questions should retract when you click a new one.

F

Flaburgan Wed 25 Sep 2013 10:12PM

@goob and @steffenvanbergerem if you have some time to accord to this topic ;)

Load More