[PATCH] Documentation: shorter sentences on the front page

[PATCH] Documentation: shorter sentences on the front page

[Valentin Gagarin]

This change focuses each sentence exclusively on one central aspect of
the project's value proposition.  The hope behind this is that it will
catch on a bit better that way.
---
 Documentation/index.html | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/index.html b/Documentation/index.html
index 6d6faf7..9777c15 100644
--- a/Documentation/index.html
+++ b/Documentation/index.html
@@ -16,9 +16,9 @@ nav_order: 0
 <h1>Spectrum — a step towards <em>usable</em> secure computing</h1>
 
 <p>
-Spectrum is a project that aims to create a computer operating system,
-based on the principle of security by compartmentalization, that has a
-lower barrier to entry and is easier to use and maintain than other
+Spectrum is a project to create a computer operating system,
+based on the principle of security by compartmentalization.
+It aims to have a lower barrier to entry and to be easier to use and maintain than other
 such systems.
 
 <p>
@@ -32,7 +32,7 @@ Spectrum is an upstream-first project.  Wherever possible, we aim to
 participate in cross-project collaboration to move the entire free
 desktop ecosystem forward, rather than designing Spectrum-specific
 solutions.  This reduces the amount of software that Spectrum as a
-small project is solely responsible for maintaining, and it derisks
+small project is solely responsible for maintaining.  It also derisks
 the project — even if Spectrum does not achieve all its goals, our
 efforts will have resulted in improvements across the board of free
 desktop systems.
-- 
2.54.0

Re: [PATCH] Documentation: shorter sentences on the front page

[Alyssa Ross]

[-- Attachment #1: Type: text/plain, Size: 1813 bytes --]

Valentin Gagarin <valentin@gagarin.work> writes:

> This change focuses each sentence exclusively on one central aspect of
> the project's value proposition.  The hope behind this is that it will
> catch on a bit better that way.
> ---
>  Documentation/index.html | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)

Reviewed-by: Alyssa Ross <hi@alyssa.is>

But also needs a Signed-off-by.

> diff --git a/Documentation/index.html b/Documentation/index.html
> index 6d6faf7..9777c15 100644
> --- a/Documentation/index.html
> +++ b/Documentation/index.html
> @@ -16,9 +16,9 @@ nav_order: 0
>  <h1>Spectrum — a step towards <em>usable</em> secure computing</h1>
>  
>  <p>
> -Spectrum is a project that aims to create a computer operating system,
> -based on the principle of security by compartmentalization, that has a
> -lower barrier to entry and is easier to use and maintain than other
> +Spectrum is a project to create a computer operating system,
> +based on the principle of security by compartmentalization.
> +It aims to have a lower barrier to entry and to be easier to use and maintain than other
>  such systems.
>  
>  <p>
> @@ -32,7 +32,7 @@ Spectrum is an upstream-first project.  Wherever possible, we aim to
>  participate in cross-project collaboration to move the entire free
>  desktop ecosystem forward, rather than designing Spectrum-specific
>  solutions.  This reduces the amount of software that Spectrum as a
> -small project is solely responsible for maintaining, and it derisks
> +small project is solely responsible for maintaining.  It also derisks
>  the project — even if Spectrum does not achieve all its goals, our
>  efforts will have resulted in improvements across the board of free
>  desktop systems.
> -- 
> 2.54.0

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]

Re: [PATCH] Documentation: shorter sentences on the front page

[Valentin Gagarin]

Signed-off-by: Valentin Gagarin <valentin@gagarin.work>

On 6/17/26 15:57, Alyssa Ross wrote:
> Valentin Gagarin <valentin@gagarin.work> writes:
> 
>> This change focuses each sentence exclusively on one central aspect of
>> the project's value proposition.  The hope behind this is that it will
>> catch on a bit better that way.
>> ---
>>   Documentation/index.html | 8 ++++----
>>   1 file changed, 4 insertions(+), 4 deletions(-)
> 
> Reviewed-by: Alyssa Ross <hi@alyssa.is>
> 
> But also needs a Signed-off-by.
> 
>> diff --git a/Documentation/index.html b/Documentation/index.html
>> index 6d6faf7..9777c15 100644
>> --- a/Documentation/index.html
>> +++ b/Documentation/index.html
>> @@ -16,9 +16,9 @@ nav_order: 0
>>   <h1>Spectrum — a step towards <em>usable</em> secure computing</h1>
>>   
>>   <p>
>> -Spectrum is a project that aims to create a computer operating system,
>> -based on the principle of security by compartmentalization, that has a
>> -lower barrier to entry and is easier to use and maintain than other
>> +Spectrum is a project to create a computer operating system,
>> +based on the principle of security by compartmentalization.
>> +It aims to have a lower barrier to entry and to be easier to use and maintain than other
>>   such systems.
>>   
>>   <p>
>> @@ -32,7 +32,7 @@ Spectrum is an upstream-first project.  Wherever possible, we aim to
>>   participate in cross-project collaboration to move the entire free
>>   desktop ecosystem forward, rather than designing Spectrum-specific
>>   solutions.  This reduces the amount of software that Spectrum as a
>> -small project is solely responsible for maintaining, and it derisks
>> +small project is solely responsible for maintaining.  It also derisks
>>   the project — even if Spectrum does not achieve all its goals, our
>>   efforts will have resulted in improvements across the board of free
>>   desktop systems.
>> -- 
>> 2.54.0

Re: [PATCH] Documentation: shorter sentences on the front page

[Alyssa Ross]

[-- Attachment #1: Type: text/plain, Size: 1297 bytes --]

Valentin Gagarin <valentin@gagarin.work> writes:

> This change focuses each sentence exclusively on one central aspect of
> the project's value proposition.  The hope behind this is that it will
> catch on a bit better that way.
> ---
>  Documentation/index.html | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/index.html b/Documentation/index.html
> index 6d6faf7..9777c15 100644
> --- a/Documentation/index.html
> +++ b/Documentation/index.html
> @@ -16,9 +16,9 @@ nav_order: 0
>  <h1>Spectrum — a step towards <em>usable</em> secure computing</h1>
>  
>  <p>
> -Spectrum is a project that aims to create a computer operating system,
> -based on the principle of security by compartmentalization, that has a
> -lower barrier to entry and is easier to use and maintain than other
> +Spectrum is a project to create a computer operating system,
> +based on the principle of security by compartmentalization.
> +It aims to have a lower barrier to entry and to be easier to use and maintain than other

Oh, this line gets a bit long for it's surroundings.  I'll just rewrap it.

(I believe most of these documents will be wrapped at 70 because that's
the Emacs default, but it doesn't necessarily have to stay that way.)

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]

Re: [PATCH] Documentation: shorter sentences on the front page

[Alyssa Ross]

This patch has been committed as 36ea9d85403a29f1e700f534020cc4592d78ee50,
which can be viewed online at
https://spectrum-os.org/git/spectrum/commit/?id=36ea9d85403a29f1e700f534020cc4592d78ee50.

This is an automated message.  Send comments/questions/requests to:
Alyssa Ross <hi@alyssa.is>