diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md
index db9fbea4d..faa1e95b1 100644
--- a/content/docs/getting-started.md
+++ b/content/docs/getting-started.md
@@ -16,7 +16,7 @@ During this tutorial, if you have any questions, feel free to ask them in [https
## init the repo
-`ipfs` uses a global local object repository, added to `~/.ipfs`:
+`ipfs` uses a global local object repository, created at `~/.ipfs`. To initialize it, run:
```sh
> ipfs init
@@ -29,11 +29,19 @@ to get started, enter:
```
+
+If you're running IPFS in the cloud, you should initialize IPFS with the
server profile (
ipfs init --profile=server) to avoid aggravating your service provider. See
go-ipfs#4343 for details.
+
+
+
+The hash after peer identity: is your peer's ID and will be different from the one shown in the above output. That's how other nodes on the network can find and connect to you. Don't bother writing it down, you can run ipfs id at any time if you need it.
+
+
-Note the hash there may differ. If it does, use the one you got.
+The HASH in the ipfs cat /ipfs/HASH/readme line above may differ from the HASH in your output. If it does, use the one you got. Be sure not to confuse these hashes with your peer identity hash; ipfs cat /ipfs/PEER_ID/readme won't work.
-Now, try running:
+Now, try following the instructions given to you by `ipfs init`:
```sh
ipfs cat /ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG/readme
@@ -132,7 +140,7 @@ the DHT, found your machine, requested the file, your machine sent it to the
gateway, and the gateway sent it to your browser.
-Note: depending on the state of the network, the `curl` may take a while. The public gateways may be overloaded or having a hard time reaching you.
+Note: depending on the state of the network, the curl may take a while. The public gateways may be overloaded or having a hard time reaching you.
You can also check it out at your own local gateway:
diff --git a/less/pages/docs.less b/less/pages/docs.less
index 3c4c7b6ac..622f62850 100644
--- a/less/pages/docs.less
+++ b/less/pages/docs.less
@@ -43,6 +43,36 @@
border-radius: 3px;
}
+.alert {
+ padding: 10px;
+ border-left-width: 4px;
+ border-left-style: solid;
+ margin-bottom: 1em;
+
+ &::after {
+ font-family: emoji;
+ margin-right: 5px;
+ display: block;
+ text-align: right;
+ opacity: 0.5;
+ }
+
+ &.alert-warning {
+ border-color: #eeaa55;
+ background: #ffeecc;
+ &::after {
+ content: "⚠️";
+ }
+ }
+ &.alert-info {
+ border-color: #9edfff;
+ background: #e3f6ff;
+ &::after {
+ content: "ℹ️️";
+ }
+ }
+}
+
@media (max-width: 970px) {
.docs-menu {
margin-bottom: 40px;
@@ -52,4 +82,4 @@
display: block;
width: 100%;
}
-}
\ No newline at end of file
+}