'Getting started' user guide


(goob) #21

And it may be that my style is a little verbose…


(Jason Robinson) #22

Yeah man you could easily write a book :wink: I tend to be verbose too especially with work emails which sometimes makes people not read them at all. But I like details :slight_smile:

I think could we maybe push this to the site if no one objects and then continue correcting it there, via Github I suppose? I don’t think there is a need to keep it in a piratepad draft forever - any mistakes will be fixed as time goes on and all documents start to accumulate mistakes from the time they are released, especially Diaspora changing all the time.

The actual short guide can then be picked out of the full version - maybe using something nifty like a HTML5 presentation or something? Image + text blocks of each feature, max 5 pages etc…


(goob) #23

I’ve already put the text into some mock-ups using the project site CSS on my web space - see this link.

I’ll need to transcribe them into the Ruby version of html that the project site uses first. Could certainly do with some help with that, so once I’ve done the donkey work and got drafts on Github, I’ll ask for some help with them.


(Sean Tilley) #24

Goob, this looks great! Well done!

It probably wouldn’t take very much at all to get these new pages put in to the current site; if you need any help doing so, I’d be happy to assist.


(goob) #25

Jay, thanks for your really useful comments and edits. I’ve added your edits and cut down the first three parts, which are now on my web space, and the PiratePad doc if you want to edit further.


(goob) #26

Sean, thanks a lot. I’ll try to do as much of this as possible, as I know you’ve got a lot on your plate, but I could do with help with:

  1. updating some images,
  2. instructing me how to be able to test the Ruby version of the site on my home test server so I can check my changes are correct before uploading them to Github, and
  3. checking through the files I commit once I’ve finished, then merging them and getting them live, hopefully before the anniversary.

I’ll email you about these tomorrow. Thanks again.


(Flaburgan) #27

Guys, just to let you know that we are currently working on “Le guide du parfait débutant” (The guide of the perfect newbie) so you can inspiring yourself / take the screenshots, even if it’s in french.


(goob) #28

I’m working through the tutorials pages, getting them ready for the new site.

One thing which would really help me is if someone would volunteer to look through the ‘tips and tricks’ page and the ‘other documentation’ page, both of which are very out of date.

These are taken straight from Diasporial. I’ve just added the User Data Manifesto to the other docs page - someone mentioned it in the jd.com crisis discussion and it looks really good - but apart from that it’s two-year old information.

If you could think of a few nifty tricks and tips for using Diaspora which are relevant to Diaspora now, and write a short bit about each of them, and check all the resources listed on the other docs page, weed out all the dead ones and add as many current ones as possible, that would be a huge help.

http://diaspora.goob.me.uk/tips.html
http://diaspora.goob.me.uk/other-docs.html

Thanks in advance.


(goob) #29

Everyone, I’ve pretty much completed my work on the tutorials pages.

What remains to be done is two very out-of-date pages.

One is a page of ‘tips and tricks’; the other is a page of links to other sites.

  1. http://diaspora.goob.me.uk/other-docs.html
    Particularly in the case of the latter, I’d like to get up-to-date links on it, so any good links you know about Diaspora, how to use it, technical information, sites which offer support or help, and so on. Please let me know.

  2. http://diaspora.goob.me.uk/tips.html
    Any if any tips for using Diaspora come to your mind, please also let me know. I’m struggling to think of any good ones at the moment.


(goob) #30

Tutorials files now on Github - PR here.


(goob) #31

If anyone would like to improve the ‘tips and tricks’ page and the ‘other documentation’ page, links to the issues are here and here.


(Jonne Haß) #32

Okay, now that the new awesome guides by @goob are online, should we redirect all requests to diasporial.com to diasporafoundation.org/tutorials?


(raven24) #33

maybe we can leave a “moved” page there for like a month or so, and then after that just redirect …?