Merge branch 'develop' into revert-683-revert-644-patch-1

8 files changed, 183 insertions, 0 deletions

diff --git a/Docs/FAQ.md b/Docs/FAQ.md
index 02336f4..8efc8c9 100644
--- a/Docs/FAQ.md
+++ b/Docs/FAQ.md
@@ -1,21 +1,55 @@
+Read this in other languages: [Français](FAQfr.md)
+
 # Frequently Asked Questions
 ## Before asking a question on GitHub or Discord, please refer to this.
 
+<br>
+
 ### **1. Where does this extension get the data?**
 A Combination of Google APIs and scraped data.
 
 We save all available data to our DB for it to be available after Google shuts down dislike counts in their API.
 
+<br>
+
 ### **2. Video dislike count doesn't update**
 Right now video dislikes are cached, and aren't updated very frequenly. Once every 2-3 days, not more often.
 
 Yeah, it's not ideal, but it is what it is. Working on improving how often we can update them.
 
+<br>
+
 ### **3. How does this work?**
 The extension collects the video id of the video you are watching, fetches the dislike (and other fields like views, likes etc) using our API, if this is the first time the video was fetched by our API, it will use the YouTube API to get the data, then stores the data in a database for caching (cached for around 2-3 days) and archiving purposes and returns it to you. The extension then displays the dislikes to you.
 
+<br>
+
 ### **4. What will happen after the YouTube API stops returning the dislike count?**
 The backend will switch to using a combination of archived dislike stats, estimates extrapolated from extension user data and estimates based on view/like ratios for videos whose dislikes weren't archived and for outdated dislike archives.
 
+<br>
+
+### **5. How is the dislike count calculated?**
+
+RYD uses the votes from it's users to extrapolate the dislike count.
+
+- If the video was uploaded after the API was shut down:
+
+  $$ \textup{RYD Dislike Count} = \left( \frac{\textup{RYD Users Like Count}}{\textup{RYD Users Dislike Count}} \right) \times \textup{Public Like Count} $$
+
+- If the RYD database somehow had the actual like and dislike count (provided by the uploader or from the archive), the dislike count will be calculated based on both - the users' votes and the archived value. The archived value will have less influence on the final count as it ages.
+
+<br>
+
+---
+
+This in video form
+
+[![IReturn YouTube Dislike Explained](https://yt-embed.herokuapp.com/embed?v=GSmmtv-0yYQ)](https://www.youtube.com/watch?v=GSmmtv-0yYQ)
+
+---
+
+<br>
+
 ## I have security / privacy concerns
 See [this page](SECURITY-FAQ.md) for more info.
diff --git a/Docs/FAQfr.md b/Docs/FAQfr.md
new file mode 100644
index 0000000..c6c702e
--- /dev/null
+++ b/Docs/FAQfr.md
@@ -0,0 +1,23 @@
+Lisez ceci dans d'autres langues : [English](FAQ.md)
+
+# Foire Aux Questions
+## Avant de poser une question sur GitHub ou Discord, veuillez vous référer à ceci.
+
+### **1. Où cette extension obtient-elle les données ?**
+Une combinaison d'API de Google et de données scrapées.
+
+Nous sauvegardons toutes les données disponibles dans notre base de données pour qu'elles soient disponibles après que Google ait supprimé le compteur de dislikes dans son API.
+
+### **2. Le nombre de dislikes sur les vidéos n'est pas mis à jour**
+Actuellement, les dislike sont mis en cache et ne sont pas mis à jour très fréquemment. Une fois tous les 2-3 jours, pas plus souvent.
+
+Oui, ce n'est pas idéal, mais c'est ce que c'est. Nous travaillons à améliorer la fréquence des mises à jour.
+
+### **3. Comment cela fonctionne-t-il ?**
+L'extension collecte l'ID de la vidéo que vous regardez, récupère les dislikes (et d'autres champs comme les vues, les likes etc.) en utilisant notre API, si c'est la première fois que la vidéo a été récupérée par notre API, elle utilisera l'API YouTube pour obtenir les données, puis stocke les données dans une base de données pour la mise en cache (mise en cache pendant environ 2-3 jours) et à des fins d'archivage et vous les renvoie. L'extension vous affiche ensuite les dislikes.
+
+### **4. Que se passera-t-il lorsque l'API YouTube ne renverra plus le nombre de dislikes ?**
+Le backend utilisera une combinaison de statistiques du nombre de dislikes archivées, d'estimations extrapolées à partir des données d'extension des utilisateurs et d'estimations basées sur les ratios vues/likes pour les vidéos dont les dislikes n'ont pas été archivées et pour les archives dont le nombre de dislikes est obsolète.
+
+## Je suis préoccupé par la sécurité / la confidentialité
+Voir [cette page](SECURITY-FAQfr.md) pour plus d'informations.
\ No newline at end of file
diff --git a/Docs/FAQru.txt b/Docs/FAQru.txt
new file mode 100644
index 0000000..5c770df
--- /dev/null
+++ b/Docs/FAQru.txt
@@ -0,0 +1,21 @@
+# Часто задаваемые вопросы

+## Прежде чем задать вопрос на GitHub или в Discord, пожалуйста, ознакомьтесь с этим.

+

+### **1. Откуда это расширение получает данные?**

+Комбинация API Google и старых данных.

+

+Мы сохраняем все имеющиеся данные в нашей базе данных, чтобы они были доступны после того, как Google прекратит подсчёт отметок «Не нравится» в своём API.

+

+### **2. Количество не понравившихся видео не обновляется**

+В настоящее время видео с отметками «Не нравится» кэшируются и обновляются не очень часто. Раз в 2-3 дня, не чаще.

+

+Да, это не идеально, но это то, что есть. Мы работаем над тем, чтобы улучшить частоту их обновления.

+

+### **3. Как это работает?**

+Расширение собирает идентификатор видео, которое вы смотрите, извлекает данные об отметках «Не нравится» (и другие поля, такие как просмотры, отметки «Нравится» и т.д.) с помощью нашего API, если видео было извлечено нашим API впервые, оно использует YouTube API для получения данных, затем сохраняет данные в базе данных для кэширования (кэшируются около 2-3 дней) и архивирования и возвращает их вам. После этого расширение отображает отметки «Не нравится» вам.

+

+### **4. Что произойдёт после того, как API YouTube перестанет возвращать данные о количестве отметок «Не нравится»?**

+Внутренняя часть нашего сервера переключится на использование комбинации архивных статистик отметок «Не нравится», оценок, экстраполированных из данных о пользователях расширения, и оценок, основанных на соотношении просмотров и отметок «Нравится» для видео, чьи отметки «Не нравится» не были заархивированы, и для устаревших архивов с отметками «Не нравится».

+

+## Я беспокоюсь о безопасности / конфиденциальности

+Более подробную информацию смотрите на [этой странице](SECURITY-FAQ.md).
\ No newline at end of file
diff --git a/Docs/SECURITY-FAQ.md b/Docs/SECURITY-FAQ.md
index b9eb259..d7f11a9 100644
--- a/Docs/SECURITY-FAQ.md
+++ b/Docs/SECURITY-FAQ.md
@@ -1,3 +1,5 @@
+Read this in other languages: [Français](SECURITY-FAQfr.md)
+
 # Security
 
 ### Are you tracking my viewing history?
diff --git a/Docs/SECURITY-FAQfr.md b/Docs/SECURITY-FAQfr.md
new file mode 100644
index 0000000..633e4c7
--- /dev/null
+++ b/Docs/SECURITY-FAQfr.md
@@ -0,0 +1,31 @@
+Lisez ceci dans d'autres langues : [English](SECURITY-FAQ.md)

+

+# Sécurité

+

+### Est-ce que vous traquer l'historique des vidéos que je visionne ?

+

+Non. Le code de l'extension est public et vous pouvez le voir par vous-même. La seule information envoyée est l'ID de la vidéo, qui est nécessaire pour récupérer le nombre de dislikes des vidéos. Aucun en-tête (headers) supplémentaire n'est envoyé. Sur la [couche de communication](https://fr.wikipedia.org/wiki/Mod%C3%A8le_OSI#Caract%C3%A9risation_r%C3%A9sum%C3%A9e_des_couches), votre adresse IP publique sera exposée au serveur, ainsi que l'heure à laquelle la demande a été faite. Toutefois, aucun de ces éléments ne permet de vous identifier de manière unique. Dans un environnement où vous ne pouvez avoir confiance en personne (zero-trust environment), le mieux que l'on puisse obtenir est une IP dynamique. Qui, aujourd'hui est la vôtre, demain est celle de votre voisin. Si vous êtes vraiment inquiet que votre IP soit tracée, vous utilisez probablement déjà un VPN.

+

+### Pouvez-vous m'identifier de manière unique si je dislike ?

+

+Oui. Lorsque vous dislikez une vidéo, nous créons pour vous un identifiant unique généré de manière aléatoire et non lié à votre compte Google. Cette mesure vise à empêcher les robots. Mais il n'y a aucun moyen de lier cet identifiant aléatoire à vous ou à votre compte YouTube personnel.

+

+### Quelles sont les informations dont vous disposez, exactement ?

+

+Juste l'ID de la vidéo. Pas vos commentaires, pas votre nom d'utilisateur, pas les personnes avec qui vous avez partagé la vidéo, pas de métadonnées supplémentaires. Rien. Juste l'ID de la vidéo.

+

+### Comment mon IP est-elle stockée ?

+

+Le backend conserve les adresses IP non hachées uniquement dans la mémoire volatile (RAM). Ces adresses ne sont pas stockées sur un disque dur et ne sont donc pas enregistrées. Nous hachons les adresses IP et stockons ça à la place. Ceci est fait pour empêcher le vandalisme de la base de données.

+

+### J'ai entendu des discussions sur OAuth, et l'accès à mon compte YouTube !

+

+Cette fonctionnalité sera facultative et fera l'objet d'une demande d'adhésion. Si vous êtes un créateur YouTube et que vous souhaitez partager vos statistiques de dislikes avec nous, vous pouvez le faire. La façon dont [OAuth](https://fr.wikipedia.org/wiki/OAuth) a été structuré, c'est en fait très sûr. Vous pouvez révoquer l'accès à votre compte à tout moment et nous donner des autorisations très spécifiques. Nous ne demanderons pas d'autorisations qui ne sont pas nécessaires. Nous ne vous demanderons que l'autorisation de consulter les statistiques de vos vidéos.

+

+### Comment puis-je faire confiance à ce compte de dislikes ?

+

+Nous avons mis en place des mesures pour prévenir les attaques de robots et nous allons continuer à travailler pour améliorer l'efficacité du système de prévention des robots : cela nous aidera à faire en sorte que le nombre de dislikes soit une bonne représentation du nombre réel. Bien entendu, il ne sera jamais précis à 100 %, c'est donc à vous de décider si vous lui faites confiance ou non.

+

+### Pourquoi ne pas partager le code du backend ? 

+

+Nous la partagerons à un moment donné - mais il n'y a pas vraiment de raison de la partager pour le moment. Cela donne un faux sentiment de sécurité, car dans un système zero-trust, nous pourrions tout aussi bien publier une version et en déployer une autre. Il y a de nombreuses raisons de garder le code caché, notamment pour lutter contre le spam. Cacher/dissimuler le code de traitement du spam est une pratique assez standard.
\ No newline at end of file
diff --git a/Docs/SECURITY-FAQru.md b/Docs/SECURITY-FAQru.md
new file mode 100644
index 0000000..f69257e
--- /dev/null
+++ b/Docs/SECURITY-FAQru.md
@@ -0,0 +1,31 @@
+Прочитать на других языках: [English](SECURITY-FAQ.md)

+

+# Безопасность

+

+### Вы отслеживаете мою историю просмотров?

+

+Нет. Код расширения находится в открытом доступе, и вы можете ознакомиться с ним самостоятельно. Единственная передаваемая информация - это идентификатор видео, который необходим для получения данных о количестве просмотров видео. Никаких дополнительных заголовков не передаётся. На коммуникационном уровне серверу будет передан ваш публичный IP-адрес, а также время, когда был сделан запрос. Однако ничто из этого не идентифицирует вас каким-либо образом. Предполагая среду с нулевым доверием, лучшее, что мы можем получить, это динамический IP. Который сегодня ваш, а завтра - вашего соседа. Если вы действительно беспокоитесь о том, что ваш IP может быть отслежен, вы, вероятно, уже используете какой-нибудь VPN.

+

+### Можете ли вы однозначно идентифицировать меня, если я оставил отметку «Не нравится»?

+

+Да. Когда вы оставляете видео отметку «Не нравится», мы создаём для вас случайно созданный уникальный идентификатор, который не привязан к вашему аккаунту Google. Это делается для избежания ботов. Но нет никакого способа привязать этот случайный идентификатор к вам или вашему личному аккаунту YouTube.

+

+### Какой именно информацией вы располагаете?

+

+Только идентификатор видео. Ни ваших комментариев, ни вашего имени пользователя, ни того, с кем вы поделились видео, ни каких-либо дополнительных метаданных. Ничего. Только идентификатор видео. 

+

+### Как хранится мой IP-адрес?

+

+Внутренняя часть нашего сервера хранит нехешированные IP-адреса только в энергозависимой памяти (ОЗУ). Эти адреса не хранятся на жёстком диске и поэтому не регистрируются. Мы хэшируем IP-адреса, и оно хранится вместо них. Это сделано для предотвращения вандализма в базе данных.

+

+### Я слышал обсуждение OAuth и доступа к моему аккаунту на YouTube!

+

+Эта функция будет необязательной и очень нужной. Если вы являетесь создателем YouTube и хотите поделиться с нами статистикой отметок «Не нравится», вы можете это сделать. По своей структуре [OAuth](https://ru.wikipedia.org/wiki/OAuth#:~:text=%D0%B1%D0%B5%D0%B7%20%D0%BF%D0%B5%D1%80%D0%B5%D0%B4%D0%B0%D1%87%D0%B8%20%D0%B5%D0%B9%20(%D1%82%D1%80%D0%B5%D1%82%D1%8C%D0%B5%D0%B9%20%D1%81%D1%82%D0%BE%D1%80%D0%BE%D0%BD%D0%B5)%20%D0%BB%D0%BE%D0%B3%D0%B8%D0%BD%D0%B0%20%D0%B8%20%D0%BF%D0%B0%D1%80%D0%BE%D0%BB%D1%8F) очень безопасен. Вы можете отозвать доступ к своему аккаунту в любое время, и можете дать нам ограниченные разрешения. Мы не будем запрашивать никаких разрешений, которые не требуются. Мы будем запрашивать разрешения только для просмотра статистики ваших видео.  

+

+### Как я могу доверять этому счётчику отметок «Не нравится»?

+

+Мы приняли меры по предотвращению атак ботов и собираемся продолжать работать над повышением эффективности системы предотвращения ботов: это поможет нам сохранить подсчёт отметок «Не нравится» как хороший представитель фактического количества. Конечно, он никогда не будет точным на 100%, поэтому вы сами решаете, доверять ему или нет.

+

+### Почему бы вам не поделиться кодом внутренней части своего сервера? 

+

+Мы поделимся им в какой-то момент - но сейчас нет никаких реальных причин делиться ею. Это даёт ложное чувство безопасности - ведь в системе с нулевым доверием мы можем с таким же успехом раскрыть одну версию, но развернуть другую. Есть много причин держать код в тайне, в частности, как мы боремся со спамом. Скрытие и запутывание кода обработки спама - это довольно стандартная практика.

diff --git a/Docs/readme.md b/Docs/readme.md
index 52567fb..5a802b2 100644
--- a/Docs/readme.md
+++ b/Docs/readme.md
@@ -1,3 +1,5 @@
+Read this in other languages: [Français](readmefr.md)

+

 **Contents**

 

 - [Guides](#guides)

diff --git a/Docs/readmefr.md b/Docs/readmefr.md
new file mode 100644
index 0000000..3d5dd5d
--- /dev/null
+++ b/Docs/readmefr.md
@@ -0,0 +1,39 @@
+Lisez ceci dans d'autres langues : [English](readme.md)
+
+**Contenu**
+
+- [Guides](#guides)
+- [FAQ](#faq)
+<!-- - [Autres listes](#autres-listes) -->
+
+<br>
+
+## Guides
+
+- [Téléchargement, installation et utilisation](https://github.com/Anarios/return-youtube-dislike/wiki/T%C3%A9l%C3%A9chargement,-installation-et-utilisation)
+- [Dépannage](https://github.com/Anarios/return-youtube-dislike/wiki/Guide-de-d%C3%A9pannage)
+<!-- - [FAQ](FAQfr.md)
+- [Quand et comment signaler les bugs](Guide__Bug_Reportingfr.md)
+- [Contribution](/CONTRIBUTINGfr.md) -->
+<!-- - [Comment mettre à jour le wiki](/) -->
+
+<br>
+
+
+## FAQ
+
+- [Général](FAQfr.md)
+- [Sécurité](SECURITY-FAQfr.md)
+
+<!-- - [Vie privée](FAQ_Privacyfr.md)
+- [Technique](FAQ_Technicalfr.md)
+- [Créateurs](FAQ_Creatorsfr.md)
+
+<br>
+
+## Autres listes
+
+- [Problèmes courants](Common_Problemsfr.md)
+- [Questions répétitives](Repeated_Questionsfr.md)
+- [Demandes répétitives de fonctionnalités](Repeated_Feature_requestsfr.md)
+- [Questions répétitives](Repeated_Issuesfr.md) -->
\ No newline at end of file