rework wording after several discussions #7
Conversation
hpk42
commented
Jun 4, 2022
•
hpk42
commented
- rephrase section1 with short "catchy" lines
- focus on "what is it" in the "try it out" section that follows
- uses lower casing and single sentences (no dots) -- i think the overall impression is simpler without capitaliisation and dots if they can be avoided ... it's also an ancient style in certain a-circles
hpk42
force-pushed
the
rework_wording
branch
3 times, most recently
from
ef49a3c
to
cbe0d4b
Compare
| <p> | ||
| A Webxdc is <b>HTML5 content</b> wrapped into a self-contained <code>.zip</code> named <code>.xdc</code>. | ||
| <br><br> | ||
| Attached to a chat, you are already done. | ||
| <br><br> | ||
| </p> |
There was a problem hiding this comment.
for me, these two lines would have helped a lot for general understanding what the remaining things are about.
why remove it?
There was a problem hiding this comment.
I think it's useful too, but maybe the intention is to encourage reading the documentation without getting into details.
There was a problem hiding this comment.
in the next section the "self-contained html5 app" is mentioned so it's not all lost. Thing is that the "Try it out" section already provides enough details to understand it. I also added some emoticons. Feel free to re-style.
Co-authored-by: bjoern <r10s@b44t.com>
index.html
Outdated
| </h1> | ||
| <p> | ||
| Download <code>.xdc</code> from below and attach it to any chat in <a href="https://get.delta.chat">Delta Chat 1.30 or newer</a>. | ||
| install and configure <a href="https://delta.chat">delta chat</a>, download <code>.xdc</code> from below, attach it as a file to a chat and hit "start". |
There was a problem hiding this comment.
| install and configure <a href="https://delta.chat">delta chat</a>, download <code>.xdc</code> from below, attach it as a file to a chat and hit "start". | |
| after installing <a href="https://delta.chat">delta chat</a>, download an <code>.xdc</code> file from below and send it in any chat, then hit "start". |
There was a problem hiding this comment.
'install and configure' is accurate but sounds laborious, perhaps could be less technical overall…
There was a problem hiding this comment.
the problem is that "install and configure" is quite a barrier however you phrase it. It will block out people who might otherwise be interested to try things out. I am wondering if we can publish a QR code for obtaining a "tmp.testrun.org" account where you can only message people on the "tmp" island for now. All outbound traffic could be blocked.
|
just had longer chat with Aaron and we trimmed the slogans a bit further. i also incorporated bjoern's feedback and re-instated the privacy policy and imprint (also they are a bit weird as they only talk about delta chat). |
