Skip to content

Commit

Permalink
Improve wording
Browse files Browse the repository at this point in the history
Co-authored-by: Matti Schneider <matti@opentermsarchive.org>
  • Loading branch information
clementbiron and MattiSG authored Jun 13, 2024
1 parent e31f88b commit f273f82
Show file tree
Hide file tree
Showing 4 changed files with 7 additions and 7 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,6 @@
title: "How to add terms using the contribution tool"
---

# How to add terms using the contribution tool
# How to add terms with the graphical contribution interface

{{< video src="https://cloud.opentermsarchive.org/index.php/s/DJ4rqJi5M8fAecL/download/how-to-navigate-through-versions-history-in-open-terms-archive.mp4" >}}
2 changes: 1 addition & 1 deletion content/terms/how-to-subscribe-rss.en.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "How to subscribe to terms changes"
title: "How to be notified of terms changes"
aliases: /subscribe-rss/
---

Expand Down
8 changes: 4 additions & 4 deletions content/terms/maintaining.en.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Maintaining declarations"
title: "Declarations maintenance"
weight: 3
---

Expand All @@ -13,7 +13,7 @@ All parts of a **terms** **declaration** (web location, selection, noise removal

Open Terms Archive needs to keep track of this changes in order to regenerate versions history from snapshots history.

## Service history
## Service history reference

To keep track of services declarations and filters changes, Open Terms Archive offers a versioning system. It is optional and should be added only when needed. It works by creating history files for terms declarations and filters, where each entry should be a previous valid declaration or filter function and should have an expiry date.

Expand Down Expand Up @@ -89,7 +89,7 @@ export const removeSharesButton = [
];
```

## Handling a terminated service
## How to terminate a service

If the service provider stops offering a service, the associated terms will become unavailable. To mark that service termination in Open Terms Archive and ensure tracking tentatives are stopped, while maintaining the possibility to explore the history:

Expand All @@ -103,6 +103,6 @@ If the service provider stops offering a service, the associated terms will beco
}
```

## Renaming a service
## How to rename a service

The consensus is to consider that a service provider renaming a service (for example, `Twitter` to `X`) is akin to terminating the previous service and opening a new one. Therefore, to apply a service renaming, open a pull request that both [terminates the previous service](#handling-a-terminated-service) and adds a new [service declaration]({{< relref "terms/tracking-new-terms#declaring-a-new-service" >}}) with the new service name. You can reuse the `documents` part of the original declaration, but should double-check that the selectors and URLs still match, as a service rename is most often accompanied by a new page layout, a new domain name, and sometimes entirely new terms.
2 changes: 1 addition & 1 deletion content/terms/navigate-trough-versions-history.en.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Navigate through versions history"
title: "How to navigate history"
weight: 1
aliases: /navigate-history/
---
Expand Down

0 comments on commit f273f82

Please sign in to comment.