manual
manual copied to clipboard
bring "your first day" to life
We could ...
- explain how to navigate the shell
- explain different editors
- give some basic information to lower the bar
Also see https://github.com/Uberspace/manual/issues/109
Please recommend vim as editor and do a little tutorial for it, alternatively nano with less functionality but easier to learn for complete newbies.
For a start:
Who is the target audience? This affects the information depth of a "Quick Start Guide".
A newbie needs much more background information regarding e.g. using the CLI or symlinks etc. Question is, whether a newbie will choose Uberspace anyway, if using a full service webhoster seems to be much easier for him/her.
What is the minimum expertise you would expect from your customer?
Second:
IMHO the very basics are email and web pages (static or dynamic CMS).
So the new customer (who maybe is switching over from a full service webhoster) needs to know the following how-tos:
-
How to access the CLI
- Tools
- Settings
- Commands
- Navigation
-
No email/web space without domain name.
- Where to get a domain name?
- How to generate the settings needed for the domain provider?
- Where to forward the domain for the respective service?
- How to test the forwardings?
-
How to configure email accounts?
- Via CLI?
- Via WebMail?
- How to set filters, forwardings, autoresponders?
- How to use Sieve?
- Important: How to forward emails to "account"@uber.space to another email address? So the customer gets information about his uberspace balance or other important messages from you.
- Settings for the email client (Thunderbird, Outlook, Mail)
-
How to configure the web page?
- How to use symlinks?
- My first "Hello world!" web page
- Example: Installation of a dynamic CMS
- Example: Installation of a static CMS
- Example: Installation of Nextcloud (nice to have so for personal use the customer can quit the O365 crap)
jmtc.
Regards from Aachen Michael
Ich würde zwei machen: Für "ich weiß auch nicht, wieso ich zu ahnungslos für diesen Rootserver zuständig war" hier und für "bei meinem bisherigen Hoster kosten Zertifikte 3€ im Monat pro Domain und ohne SSH konnte ich nichtmal composer install machen" dort. Große Unterschiede.
Wo und wie muss ich eine index.html ablegen, und was muss ich in meinen Browser tippen, um sie dann gehostet zu sehen?
- Meine erste Mail: Wie lautet die Space-eigene Mailadressen, und wie komme ich ins Webmail?
- passwordless SSH einrichten, mit Beispiel-Befehl für scp/rsync
Also see https://github.com/Uberspace/manual/issues/356
* How to access the CLI
we do cover this in https://lab.uberspace.de/howto_ssh.html now, I don't know if we should give more hints about how using a CLI because there are so many tutorials about that. Maybe we can give a nudge how to find them?
* No email/web space without domain name.
that is not true, we provide uber.space
domains from the start :wink: But we could give some hints how to use and setup DNS for your own domains, but this is pretty hard because it very much depends on your domain registrar and they should tell you how to do it.
* How to configure email accounts?
this is covered by the manual already, I actually cant imagine how to write a howto that does not just repeat the manual pages, do you have any ideas?
* **Important:** How to forward emails to "account"@uber.space to another email address? So the customer gets information about his uberspace balance or other important messages from you.
this will be covered soon by a form in the dashboard
* How to configure the web page? * How to use symlinks? * My first "Hello world!" web page
this is covered here now: https://lab.uberspace.de/howto_website.html we are happy if you have ideas how to improve them, PRs and issues are welcome in the lab repo :)
* Example: Installation of a dynamic CMS * Example: Installation of a static CMS * Example: Installation of Nextcloud (nice to have so for personal use the customer can quit the O365 crap)
this is covered by the guides, isn't it? Or do you have ideas how to give more hands on to the users, how to use our guides?