[HOME] [DOWNLOAD] [DOCS] [BLOG] [SUPPORT] [TIPS] [ISSUES] [Priority Support]

introduction for "user friendly" documentor


#21

Good day,

Thank you very much.

Sadly, I have to say that I am agreeing with @HulaHoop regarding the length and phrasing. I am fully aware of the fact that it is rather complex and hard to condense a lot of very important information into what amounts to just a few lines, though may I recommend taking a look at how the guides design’s would be? Obviously, the decision on which one will be used depends on the way the guide is phrased, though currently, there are two potential candidates you may find here and here. May I recommend basing your guide on one of these kinds of layout?

The “long wall design”, would necessitate rather short chapters of less then 500 letters, as to not overwhelm a user and would thus litterally only be used to cover the bare minimum, whereas the “page based one” could enable chapters of up to 1000 letters, due to its more segregated and thus easier to digest appearance and thus would enable to go slightly more indepth. If the latter is used though, more and shorter chapters would have to be created, breaking up certain topics.

Again, thank you very much for your support.

Have a nice day,

Ego


#22

Ok. Now?

Whonix for Windows Quick-Start Guide v0.3

  1. Introduction

Whonix for Windows was designed to be a simple introduction, to enable people to experiment with Whonix in a familiar environment without the necessity of complex imports or OS switches.

As you learn how to use Whonix, do not forget that Windows cannot provide a secure foundation for Whonix.

  1. Download, verify and install Whonix

    a) Download the installer. (Whonix-Installer for Windows)
    https://download.whonix.org/windows/Whonix-Installer.exe

    b) Verify the installer.

    Download the signing key [1] and the installer’s Signature. [2]
    (Verify the Installer).
    https://www.whonix.org/wiki/Installer/Verify_the_Installer_using_the_command_line

    c) Install Whonix.

    Execute the verified Whonix-Installer.exe and follow its instructions. [3]

    Please note: Due to the size of Whonix and the accompanying files, this may take up to half an hour.

    d) Start using Whonix

    You may now enjoy Whonix and all its features, either via Whonix.exe or Whonix for Windows, which you should find on your desktop or VirtualBox.

  2. After installation.

Change passwords for “user” and “root” in Whonix-Gateway and Whonix-Workstation. [4]

See Software [5] for a list of pre-installed applications.

See Install Additional Software [6] if necessary.

Regularly check for security updates and apply them. [7]

Always use the Whonix-UI to shut-down Whonix before shutting down the host system.

Read the About [8], Warning [9] and Do Not [10] pages to make sure that Whonix is the right tool for you and you understand well its limitations.

[1] https://download.whonix.org/windows/ego.asc
[2] https://download.whonix.org/windows/Whonix-Installer.exe.asc
[3] https://www.whonix.org/wiki/DoNot#Don.27t_change_settings_if_you_don.27t_know_their_consequences.
[4] https://www.whonix.org/wiki/Post_Install_Advice#Change_Passwords
[5] https://www.whonix.org/wiki/Software
[6] https://www.whonix.org/wiki/Install_Software
[7] https://www.whonix.org/wiki/Security_Guide#Updates
[8] https://www.whonix.org/wiki/About
[9] https://www.whonix.org/wiki/Warning
[10] https://www.whonix.org/wiki/DoNot


#23

Bingo! now you have the right idea :slight_smile:


#24

Excellent work lwatts. +1

@HulaHoop if the Whonix team is happy, can this then officially progress as the “Whonix Quick-start Guide for Windows” to the relevant repositories i.e. get uploaded if Patrick is also happy with it?

We know most people still use Windows in this day and age (unbelievably; serious Stockholm Syndrome), and have previously complained to Patrick about documentation not having a clean and easy guide anywhere. Well, now they have it.

It would be nice to knock this off the list. Then there is just the other operating platforms e.g. Linux etc. for the Quick-start Guide.

Perhaps lwatts would be nice enough to help out with that also, since he is a Linux expert and has technical writing experience. :slight_smile:


#25

I guess now it’s time to add it to https://github.com/Whonix/Whonix-Website when @Ego gets a chance to?


#26

I still need to fix links and/or footnotes, but I’m not sure how. This forum editor adds its own formatting where I didn’t really want it. Should I just wait until it gets into the wiki then edit in place there?

And of course, the Debian version of the QSG is next on my list. I’m not sure about a Qubes version, simply because I’m not familiar enough with Qubes to know if you could call installation instructions, a “Quick Start Guide”. ;^) Anyway, Debian is next on my list. Thanks! - lw


#27

Not sure. Btw you can prevent the forum’s formatting by using code tags.

```
text
```

#28

Thanks, Patrick, but I didn’t really want the monospace font. (And besides, “code tags” are some of the formatting that it put in against my will in my first version posted.) No problem; I’ll figure out some way to clean it up.


#29

Good day,

Great. Will transfer it to the Github repository then. By the way, as I mentioned previously, the best format would be to use plain and simple markdown, considering that is what’s used by the site anyways.

Have a nice day,

Ego


#30

Hi,

Thanks for all your efforts. Re: the above, the wiki’s landing site for Qubes has already outlined the simple method for Qubes i.e. downloading the Whonix templates, with no verification steps required and simple set-up.

See here:

http://kkkkkkkkkk63ava6.onion/wiki/Qubes/Install#Landing

Of course, these steps are not needed if one just installs the Whonix templates automatically (checkboxes), when first installing Qubes. That’s the beauty of it.

Re: Installing Qubes in the first place, this should not be the concern of the Whonix wiki IMO, except maybe a reference to here: