[jitsi-dev] Documentation: Install and Setup Jitsi on Windows


#1

REMINDER: Do I need to discuss Java somewhere, or does the Windows installer take care of this automatically?

I'm not sure what the URL for the images will be so I just included the file name for now.

Also note that the double square brackets are links: e.g. [[registrarless SIP accounts]] and [[Set up Facebook Chat]]. I will write those pages next.

David

INSTALL AND SETUP JITSI ON WINDOWS

! Download and Install

# Visit the [[https://jitsi.org/index.php/Main/Download | Jitsi Download page]]
download-page.png

# Click on the "Microsoft Windows Installers (32-bit version)." If know that you have [[http://windows.microsoft.com/en-US/windows-vista/32-bit-and-64-bit-Windows-frequently-asked-questions

64-bit Windows ]] you can click on the "64-bit version" instead.

# Start the process by clicking "Run"

# The installation starts. When it is complete Jitsi will launch.

! First Use

# The first time you run Jitsi, you may get a warning from your Firewall. If you click "Cancel" Jitsi can still communicate through public servers such as Google Chat, Facebook, and Yahoo Messenger. However, clicking "Allow access" enables an advanced feature known as [[registrarless SIP accounts]]
windows-firewall-alert.png

# Jitsi lets you log into several chat accounts at once. Fill out the username and password for the accounts you already have. If you don't have any accounts with the providers listed, create a new account by clicking on one of the "Not registered yet" links.
first-run-sign-in-sample-input.png

# After filling in the username and and passwords for the accounts you want to use, click "Sign in." You are ready to chat!
main-window.png

# If you are signing into Facebook, an extra step is required. See [[Set up Facebook Chat]]

Now that you are signed in, the next steps are:
* [[Add a friend]]
* [[Chat]]
* [[Voice call]]
* [[Video call]]


#2

Hey David

Thanks!
I've saved the page on
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows, but
haven't linked to it yet. If you sign-in, you'll see a link on the top of
the page to upload the pictures.

The section "Download and Install" might need some screenshots of the
installer, especially the question about shortcuts and protocol association,
the UAC prompt and that the run is AFAIK optional. However a don't think a
screenshot of the download-page is necessary. But that's your call.

Regards,
Ingo

···

-----Original Message-----
From: David Bolton [mailto:davidkbolton@gmail.com]
Sent: Sonntag, 13. Januar 2013 21:54
To: Jitsi Developers
Subject: [jitsi-dev] Documentation: Install and Setup Jitsi on Windows
REMINDER: Do I need to discuss Java somewhere, or does the Windows
installer take care of this automatically?

I'm not sure what the URL for the images will be so I just included the
file name for now.

Also note that the double square brackets are links: e.g.
[[registrarless SIP accounts]] and [[Set up Facebook Chat]]. I will
write those pages next.

David

INSTALL AND SETUP JITSI ON WINDOWS

! Download and Install

# Visit the [[https://jitsi.org/index.php/Main/Download | Jitsi Download
page]] download-page.png

# Click on the "Microsoft Windows Installers (32-bit version)." If know
that you have
[[http://windows.microsoft.com/en-US/windows-vista/32-bit-and-64-bit-Wind
ows- frequently-asked-questions | 64-bit Windows ]] you can click on the
"64-bit version" instead.

# Start the process by clicking "Run"

# The installation starts. When it is complete Jitsi will launch.

! First Use

# The first time you run Jitsi, you may get a warning from your
Firewall. If you click "Cancel" Jitsi can still communicate through
public servers such as Google Chat, Facebook, and Yahoo Messenger.
However, clicking "Allow access" enables an advanced feature known as
[[registrarless SIP accounts]]
windows-firewall-alert.png

# Jitsi lets you log into several chat accounts at once. Fill out the
username and password for the accounts you already have. If you don't
have any accounts with the providers listed, create a new account by
clicking on one of the "Not registered yet" links.
first-run-sign-in-sample-input.png

# After filling in the username and and passwords for the accounts you
want to use, click "Sign in." You are ready to chat! main-window.png

# If you are signing into Facebook, an extra step is required. See [[Set
up Facebook Chat]]

Now that you are signed in, the next steps are:
* [[Add a friend]]
* [[Chat]]
* [[Voice call]]
* [[Video call]]


#3

For page titles and section headings do we want to use sentence-style (first word capitalized, proper nouns caplitalized, everything else lowercase) or title case (Every word capitalized except for articles, prepositions, and conjunctions, and first and last word always capitalized).

Currently the website is not consistent. (For example see https://jitsi.org/index.php/Documentation/DeveloperDocumentation )

I have a slight preference for sentence-style capitalization, only because the rules are simpler. In English, title case is still taught in school but outside of academic publications sentence-style maybe more common (if you take a look at most newspapers, Wikipedia, etc.).

My main concern, however, is consistency (before creating many more pages).

David


#4

For page titles and section headings do we want to use sentence-style
(first word capitalized, proper nouns caplitalized, everything else
lowercase) or title case (Every word capitalized except for articles,
prepositions, and conjunctions, and first and last word always

capitalized).

Currently the website is not consistent. (For example see
https://jitsi.org/index.php/Documentation/DeveloperDocumentation )

I have a slight preference for sentence-style capitalization, only
because the rules are simpler. In English, title case is still taught in
school but outside of academic publications sentence-style maybe more
common (if you take a look at most newspapers, Wikipedia, etc.).

I'd personally like the title case, but I'm also sure to make enough
mistakes as my mother's tongue is German. I'm fine with either of it. Choose
one.

My main concern, however, is consistency (before creating many more

pages).

Feel free to choose a style and change the pages to be consistent.

David

Ingo


#5

I uploaded the images and added instructions for each step of the installation wizard.
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows

Please review my explanation of the "Associated Protocols". I assumed it was talking about web links that start with sip:// and xmpp://

David

···

On 1/13/2013 3:23 PM, Ingo Bauersachs wrote:

I've saved the page on
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows
The section "Download and Install" might need some screenshots of the
installer, especially the question about shortcuts and protocol association,
the UAC prompt and that the run is AFAIK optional. However a don't think a
screenshot of the download-page is necessary. But that's your call.


#6

I believe title case was most probably our original intention so there are
probably more pages following that one.

--sent from my mobile

···

On Jan 13, 2013 11:29 PM, "Ingo Bauersachs" <ingo@jitsi.org> wrote:

> For page titles and section headings do we want to use sentence-style
> (first word capitalized, proper nouns caplitalized, everything else
> lowercase) or title case (Every word capitalized except for articles,
> prepositions, and conjunctions, and first and last word always
capitalized).
>
> Currently the website is not consistent. (For example see
> https://jitsi.org/index.php/Documentation/DeveloperDocumentation )
>
> I have a slight preference for sentence-style capitalization, only
> because the rules are simpler. In English, title case is still taught in
> school but outside of academic publications sentence-style maybe more
> common (if you take a look at most newspapers, Wikipedia, etc.).

I'd personally like the title case, but I'm also sure to make enough
mistakes as my mother's tongue is German. I'm fine with either of it.
Choose
one.

> My main concern, however, is consistency (before creating many more
pages).

Feel free to choose a style and change the pages to be consistent.

> David

Ingo


#7

I uploaded the images and added instructions for each step of the
installation wizard.
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows

Thanks! The guide looks great now and I enabled the link to it on the User
Documentation page.

For some future images, maybe make them a bit larger. For example the
procotol-setup screenshot is barely readable. I've also changed how they are
embedded: please use the Attach:filename.png syntax instead of using
absolute URLs.

Please review my explanation of the "Associated Protocols". I assumed it
was talking about web links that start with sip:// and xmpp://

Thats correct.

David

Ingo


#8

I've saved the page on
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows
The section "Download and Install" might need some screenshots of the
installer, especially the question about shortcuts and protocol association,
the UAC prompt and that the run is AFAIK optional. However a don't think a
screenshot of the download-page is necessary. But that's your call.

I uploaded the images and added instructions for each step of the
installation wizard.
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows

Awesome! Great work David!

Could you please link to this from the "User Documentation" page?

Please review my explanation of the "Associated Protocols". I assumed it
was talking about web links that start with sip:// and xmpp://

Just sip: and xmpp: (no //)

Emil

···

On 14.01.13, 07:35, David Bolton wrote:

On 1/13/2013 3:23 PM, Ingo Bauersachs wrote:

David

--
https://jitsi.org


#9

OK. I'll use title case.

David

···

On 1/13/2013 4:51 PM, Emil Ivov wrote:

I believe title case was most probably our original intention so there are probably more pages following that one.


#10

I uploaded the images and added instructions for each step of the
installation wizard.
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows

Thanks! The guide looks great now and I enabled the link to it on the User
Documentation page.

Oh, OK, hand't seen this. Thanks Ingo!

Emil

···

On 14.01.13, 13:40, Ingo Bauersachs wrote:

For some future images, maybe make them a bit larger. For example the
procotol-setup screenshot is barely readable. I've also changed how they are
embedded: please use the Attach:filename.png syntax instead of using
absolute URLs.

Please review my explanation of the "Associated Protocols". I assumed it
was talking about web links that start with sip:// and xmpp://

Thats correct.

David

Ingo

--
https://jitsi.org


#11

Hey David,

The user documentation looks really great!!

I've noticed that you use the stable version for the screenshots and the instructional videos, however we've put quite a lot of effort in the new jitsi look and having in mind the upcoming release, don't you think we could use the unstable version for these?

Cheers,
Yana

···

On Jan 14, 2013, at 1:46 PM, Emil Ivov <emcho@jitsi.org> wrote:

On 14.01.13, 13:40, Ingo Bauersachs wrote:

I uploaded the images and added instructions for each step of the
installation wizard.
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows

Thanks! The guide looks great now and I enabled the link to it on the User
Documentation page.

Oh, OK, hand't seen this. Thanks Ingo!

Emil

For some future images, maybe make them a bit larger. For example the
procotol-setup screenshot is barely readable. I've also changed how they are
embedded: please use the Attach:filename.png syntax instead of using
absolute URLs.

Please review my explanation of the "Associated Protocols". I assumed it
was talking about web links that start with sip:// and xmpp://

Thats correct.

David

Ingo

--
https://jitsi.org


#12

Hey Yana

The videos are from another user and already up there for some time. The
only screenshot that shows the UI in the installation tutorial is from the
current windows nightly, so everything okay here.

Regards,
Ingo

From: Yana Stamcheva [mailto:yana@jitsi.org]
Sent: Montag, 14. Januar 2013 14:13
To: dev@jitsi.java.net
Subject: [jitsi-dev] Re: Documentation: Install and Setup Jitsi on Windows

Hey David,

The user documentation looks really great!!

I've noticed that you use the stable version for the screenshots and the
instructional videos, however we've put quite a lot of effort in the new
jitsi look and having in mind the upcoming release, don't you think we

could

use the unstable version for these?

Cheers,
Yana

>
>
>>> I uploaded the images and added instructions for each step of the
>>> installation wizard.
>>> https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows
>>
>> Thanks! The guide looks great now and I enabled the link to it on the

User

>> Documentation page.
>
> Oh, OK, hand't seen this. Thanks Ingo!
>
> Emil
>>
>> For some future images, maybe make them a bit larger. For example the
>> procotol-setup screenshot is barely readable. I've also changed how

they

are
>> embedded: please use the Attach:filename.png syntax instead of using
>> absolute URLs.
>>
>>> Please review my explanation of the "Associated Protocols". I assumed

it

···

-----Original Message-----
On Jan 14, 2013, at 1:46 PM, Emil Ivov <emcho@jitsi.org> wrote:
> On 14.01.13, 13:40, Ingo Bauersachs wrote:
>>> was talking about web links that start with sip:// and xmpp://
>>
>> Thats correct.
>>
>>> David
>>
>> Ingo
>>
>>
>
> --
> https://jitsi.org


#13

Oh ok!

Sorry about the confusion then!

···

On Jan 14, 2013, at 2:21 PM, "Ingo Bauersachs" <ingo@jitsi.org> wrote:

Hey Yana

The videos are from another user and already up there for some time. The
only screenshot that shows the UI in the installation tutorial is from the
current windows nightly, so everything okay here.

Regards,
Ingo

-----Original Message-----
From: Yana Stamcheva [mailto:yana@jitsi.org]
Sent: Montag, 14. Januar 2013 14:13
To: dev@jitsi.java.net
Subject: [jitsi-dev] Re: Documentation: Install and Setup Jitsi on Windows

Hey David,

The user documentation looks really great!!

I've noticed that you use the stable version for the screenshots and the
instructional videos, however we've put quite a lot of effort in the new
jitsi look and having in mind the upcoming release, don't you think we

could

use the unstable version for these?

Cheers,
Yana

On Jan 14, 2013, at 1:46 PM, Emil Ivov <emcho@jitsi.org> wrote:

On 14.01.13, 13:40, Ingo Bauersachs wrote:

I uploaded the images and added instructions for each step of the
installation wizard.
https://jitsi.org/index.php/Documentation/InstallAndSetupOnWindows

Thanks! The guide looks great now and I enabled the link to it on the

User

Documentation page.

Oh, OK, hand't seen this. Thanks Ingo!

Emil

For some future images, maybe make them a bit larger. For example the
procotol-setup screenshot is barely readable. I've also changed how

they

are

embedded: please use the Attach:filename.png syntax instead of using
absolute URLs.

Please review my explanation of the "Associated Protocols". I assumed

it

was talking about web links that start with sip:// and xmpp://

Thats correct.

David

Ingo

--
https://jitsi.org