Hello,
I've spent some time going through the website templates for spelling
and grammar issues, and have gone from A to F so far. Just figured out
git format-patch, so I thought I'd submit some patches containing
suggested corrections. They're each corrections for individual files, to
make them easy to review.
I held back on issues of writing style, as that's more subjective.
One issue that I have found myself unable to solve is the FAQ about
distributed ledger technologies, because the question only sort-of makes
sense for the given answer. Seems like the question is asking about
whether, but the answer seems to focus more on using distributed ledgers
in GNUnet. Should I open an issue on the bug tracker for it?
I hope that these patches prove to be useful.
Thank you,
William Liquorice
>From fcf09280c4468fae152855250545365ab02de197 Mon Sep 17 00:00:00 2001
From: William Liquorce <[email protected]>
Date: Fri, 9 Apr 2021 14:54:36 +0100
Subject: [PATCH 1/5] Proofreading changes and corrections to
applications.html.j2
---
template/applications.html.j2 | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/template/applications.html.j2 b/template/applications.html.j2
index 43b0dd2..1b47258 100644
--- a/template/applications.html.j2
+++ b/template/applications.html.j2
@@ -19,7 +19,7 @@
hierarchy, GNS uses a directed graph. Naming conventions
are similar to DNS, but queries and replies are private even
with respect to peers providing the answers. The integrity of
- records and privacy of look-ups is cryptographically secured.
+ records and privacy of look-ups are cryptographically secured.
<!-- Too technical: GNS integrates
a robust, efficient and instant key revocation mechanism. -->
{% endtrans %}
@@ -162,7 +162,7 @@
{% trans %}
<a href="https://gitlab.com/gnunet-messenger/cadet-gtk";>Cadet-GTK</a>
is a convenient but feature-rich graphical application
- providing messaging using especially the CADET subsystem. It is
+ providing messaging using the CADET subsystem. It is
developed using GTK and libhandy for a convergent design.
{% endtrans %}
</p>
@@ -181,7 +181,7 @@
<p>
{% trans %}
<a href="https://git.gnunet.org/groupchat.git/";>groupchat</a>
- is a terminal user interface providing messaging using especially the CADET subsystem. It is
+ is a terminal user interface providing messaging using the CADET subsystem. It is
developed using nim. Cadet-GTK and groupchat are planned to be compatible.
{% endtrans %}
</p>
--
2.25.1
>From 9d8dd8a240a1f845615ad93e48b5c42c309b0cbb Mon Sep 17 00:00:00 2001
From: William Liquorce <[email protected]>
Date: Fri, 9 Apr 2021 14:59:32 +0100
Subject: [PATCH 2/5] Proofreading changes and corrections to
architecture.html.j2
---
template/architecture.html.j2 | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/template/architecture.html.j2 b/template/architecture.html.j2
index 4165c86..0406774 100644
--- a/template/architecture.html.j2
+++ b/template/architecture.html.j2
@@ -25,7 +25,7 @@
messaging layer (CADET), a public key infrastructure
(GNS) and a pluggable transport system (TRANSPORT).<br>
Using public keys for addresses
- and self-organized decentralized routing algorithms,
+ and self-organizing decentralized routing algorithms,
these subsystems replace the traditional TCP/IP stack.
{% endtrans %}
</p>
@@ -38,7 +38,7 @@
{% trans %}
GNUnet is implemented using a multi-process architecture.
Each subsystem runs as a separate process, providing
- fault-isolation and enabling tight permissions to be
+ fault isolation and enabling tight permissions to be
granted to each subsystem. Naturally, the
implementation is a <a href="https://www.gnu.org/";>GNU</a>
package, and will always remain free software.
@@ -51,13 +51,13 @@
<div class="col-md">
<h2>{{ _("System architecture") }}</h2>
<p>
- Read more about the system architecure in the respective section of our <a href="https://docs.gnunet.org/handbook/gnunet.html#System-Architecture"; target="_blank">handbook</a>.
+ Read more about the system architecture in the corresponding section of our <a href="https://docs.gnunet.org/handbook/gnunet.html#System-Architecture"; target="_blank">handbook</a>.
</p>
</div>
<div class="col-md">
<h2>{{ _("Subsystems") }}</h2>
<p>
- Read more about the subsystems (or GNUnet services) in the respective section of our <a href="https://docs.gnunet.org/handbook/gnunet.html#Code-overview"; target="_blank">handbook</a>.
+ Read more about the subsystems (or GNUnet services) in the corresponding section of our <a href="https://docs.gnunet.org/handbook/gnunet.html#Code-overview"; target="_blank">handbook</a>.
</p>
</div>
</div>
@@ -72,7 +72,7 @@
<div class="col-md">
<h2>{{ _("APIs") }}</h2>
<p>
- GNUnet offers variaty of APIs for <a href="https://docs.gnunet.org/handbook/gnunet.html#Interprocess-communication-API-_0028IPC_0029"; target="_blank">accessing services</a> (using IPC), <a href="https://docs.gnunet.org/handbook/gnunet.html#Service-API";>running services</a>, <a href="https://docs.gnunet.org/handbook/gnunet.html#Message-Queue-API";>message queues</a>, or <a href="https://docs.gnunet.org/handbook/gnunet.html#Cryptography-API"; target="_blank">cryptographic operations</a>.
+ GNUnet offers a variety of APIs for <a href="https://docs.gnunet.org/handbook/gnunet.html#Interprocess-communication-API-_0028IPC_0029"; target="_blank">accessing services</a> (using IPC), <a href="https://docs.gnunet.org/handbook/gnunet.html#Service-API";>running services</a>, <a href="https://docs.gnunet.org/handbook/gnunet.html#Message-Queue-API";>message queues</a>, or <a href="https://docs.gnunet.org/handbook/gnunet.html#Cryptography-API"; target="_blank">cryptographic operations</a>.
</p>
</div>
</div>
--
2.25.1
>From 187e17b0fc0216895dd41c5f005521e57c02f8f1 Mon Sep 17 00:00:00 2001
From: William Liquorce <[email protected]>
Date: Fri, 9 Apr 2021 14:59:49 +0100
Subject: [PATCH 3/5] Proofreading changes and corrections to engage.html.j2
---
template/engage.html.j2 | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/template/engage.html.j2 b/template/engage.html.j2
index 000396a..d5bb2f2 100644
--- a/template/engage.html.j2
+++ b/template/engage.html.j2
@@ -26,9 +26,9 @@
</p>
<h4>Mumble</h4>
<p>
- We have a monthly get-together on mumble where we talk about recent developments, strategies, and politics.<br>
+ We have a monthly get-together on Mumble where we talk about recent developments, strategies, and politics.<br>
We come together on that day of the month, where n.day==n.month. E.g. we’ll meet on 6th of June, 7th of July, 8th of August, 9th of September, 10th of October and so on. We will usually start around 8 PM CEST, but try to be there earlier and stay longer just to hang around together.<br>
- To connect just enter "gnunet.org" as server into your mumble client; leave everything else as default.
+ To connect just enter "gnunet.org" as server into your Mumble client; leave everything else as default.
</p>
</p>
<h4>PSYC</h4>
@@ -46,7 +46,7 @@
<div class="col-md">
<h2>Install GNUnet!</h2>
<p>
- Another thing you might want now is your own GNUnet installation. As we haven’t packaged the new versions yet (June 2019) we provide <a href="https://gnunet.org/en/install.html";>some tutorials how to install step-by-step</a>.
+ Another thing you might want now is your own GNUnet installation. As we haven’t packaged the new versions yet (as of June 2019) we provide <a href="https://gnunet.org/en/install.html";>some tutorials how to install step-by-step</a>.
</p>
<h2>Use GNUnet!</h2>
<p>
@@ -62,8 +62,8 @@
<li>If you do not want to use the public bug tracker, you can also eMail to [email protected].</li>
<li>Please inform us if your operating system or package manager applies any vendor changes to GNUnet which you know about (to exclude potential problems introduced by third parties).</li>
<li>Wait until your bug report is acknowledged/replied to. Note that only volunteers work on this, responses may take a while.</li>
- <li>Please follow up with eventual questions about the bug. </li>
- <li>Once a fix is there: Check if it's working as expected, so that we can properly close the bug report and/or give you credits :)</li>
+ <li>Please follow up on any questions about the bug.</li>
+ <li>Once a fix is there: Check if it's working as expected, so that we can properly close the bug report and/or give you credit :)</li>
</ul>
<h2>Contribute!</h2>
<p>
--
2.25.1
>From f1a8c92019a79f3d77896215eb277cd71e1aba20 Mon Sep 17 00:00:00 2001
From: William Liquorce <[email protected]>
Date: Fri, 9 Apr 2021 15:00:02 +0100
Subject: [PATCH 4/5] Proofreading changes and corrections to ev.html.j2
---
template/ev.html.j2 | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/template/ev.html.j2 b/template/ev.html.j2
index d8589b1..d35480f 100644
--- a/template/ev.html.j2
+++ b/template/ev.html.j2
@@ -40,7 +40,7 @@
to support GNUnet e.V. and in particularly contribute to the
technical development within their means. For further
details, we refer to the
- <a href="https://git.gnunet.org/gnunet-ev.git/";>Satzung</a>
+ <a href="https://git.gnunet.org/gnunet-ev.git/";>Satzung (Charter)</a>
(currently only available in German, translations welcome).
{% endtrans %}
</p>
@@ -52,7 +52,7 @@
<h3>{{ _("Governance") }}</h3>
<p>
{% trans %}
- You can find our "Satzung", and the list of members under
+ You can find our charter, and the list of members under
<a href="https://git.gnunet.org/gnunet-ev.git/tree/satzung.tex";>https://git.gnunet.org/gnunet-ev.git/tree/satzung.tex</a>.
The current board consists of:
<dl><dt>Vorsitz</dt>
--
2.25.1
>From 9e1bca3d800e03bcfe53ecdc671097b94183098c Mon Sep 17 00:00:00 2001
From: William Liquorce <[email protected]>
Date: Fri, 9 Apr 2021 15:00:14 +0100
Subject: [PATCH 5/5] Proofreading changes and corrections to faq.html.j2
---
template/faq.html.j2 | 20 ++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
diff --git a/template/faq.html.j2 b/template/faq.html.j2
index 7c395dc..6c9a66a 100644
--- a/template/faq.html.j2
+++ b/template/faq.html.j2
@@ -182,9 +182,9 @@
<p>
{% trans %}
A: There is currently no proxy (like fproxy in Freenet) for GNUnet that would
- make it accessible with a browser. It is possible to build such a proxy and
- all one needs to know is the protocol used between browser and proxy and a
- swift look at the GNUnet code for file-sharing.
+ make it accessible via a browser. It is possible to build such a proxy and
+ all one needs to know is the protocol used between the browser and the proxy and
+ the GNUnet code for file-sharing.
{% endtrans %}
</p>
</section>
@@ -207,7 +207,7 @@
</section>
<section>
- <h3>{{ _("On top of which operating systems does GNUnet run?") }}</h3>
+ <h3>{{ _("Which operating systems does GNUnet run on?") }}</h3>
<p>
{% trans %}
A: GNUnet is being developed and tested primarily under Debian GNU/Linux.
@@ -283,7 +283,7 @@
</section>
<section>
- <h3>{{ _("How does GNS compare to other name systems") }}</h3>
+ <h3>{{ _("How does GNS compare to other name systems?") }}</h3>
<p>
{% trans %}
A: A scientific paper on this topic
@@ -397,8 +397,8 @@
there are still registrars that determine who owns a name.
<br><br>
With GNS, we decentralize the database and also decentralize the
- responsibility for naming: each user runs his own personal root zone and is
- thus in complete control of the names he uses. GNS also has many additional
+ responsibility for naming: each user runs their own personal root zone and is
+ thus in complete control of the names they use. GNS also has many additional
features (to keep names short and enable migration) which don't even make
sense in the context of CoDoNS.
@@ -442,9 +442,9 @@
A: Handshake is a blockchain-based method for root zone governance.
Hence, it does not address the name resolution process itself but
delegates resolution into DNS after the initial TLD resolution.
- Not taking sustainablility considerations into account, handshake
+ Not taking sustainablility considerations into account, Handshake
could be used as an additional supporting GNS root zone governance
- model but we currently do not have such plans in mind.
+ model, but we currently do not have such plans in mind.
{% endtrans %}
</p>
</section>
@@ -918,7 +918,7 @@
Here, there are differences in terms of application domain and how
specifically anonymity is achieved.
Anonymous routing is a hard research topic, so for a superficial
- comparisson like this one we focus on the latency.
+ comparison like this one we focus on the latency.
Another important factor is the programming language.
Type-safe languages may offer certain security benefits; however, this may come at the cost of significant increases in resource consumption which in turn may reduce anonymity.
{% endtrans %}
--
2.25.1
