updated readme (#191)

* updated readme

* applied comments from PR review

README.md

@@ -1,4 +1,4 @@
-<img src="https://github.com/Horizontal-org/Tella-Android/blob/master/Tella-02-feature-B.png" alt="Tella" width="350"/>
+![Tella](docs/feature_image.png?raw=true "Tella")
 
 ## Table of Contents
 
@@ -14,73 +14,72 @@
 
 6. [Contributing to the code](#contributing)
 
-7. [Contact us](#contact)
+7. [Translating the app](#translating)
+
+8. [Contact us](#contact)
 
 ## Overview <a id="overview"></a>
 
-Tella is a human rights documentation app for Android and iOS. **The iOS version of Tella is not yet publicly available. [All issues in milestone `v1.0`](https://github.com/Horizontal-org/Tella-iOS/milestone/1) need to be completed before Tella for iOS can be published.**
+In challenging environments, with limited or no internet connectivity or in the face of repression, Tella is an app that makes it easier and safer to document human rights violations and collect data. Tella is available Android and iOS. 
 
-In challenging environments--with limited or no internet connectivity or in the face of repression--Tella makes it easier and safer to document events, whether that’s violence, human rights violations, corruption, or electoral fraud.
+More information about how to get Tella --including user guides-- can be found on our [documentation platform](https://docs.tella-app.org/).
+
+| [![Encrypting](docs/encrypting.gif)](https://tella-app.org/features#encryption/) | [![Server Connections](docs/connections.gif)](https://tella-app.org/for-organizations) |
+|:---:|:---:|:---:|
+| Taking and encrypting a photo | Collecting data |
 
-Tella:
-- encrypts photo, video, and audio files in a separate gallery so it cannot be accessed from the phone's regular gallery or file explorer
-- hides itself by changing its name and icon in the list of apps
-- captures metadata when taking photos, videos, and audio recordings to verify the origin of the files
-- allows users to quickly delete all files in Tella's encrypted Gallery
-- enables users working with a group or organization to collect and send data to a server without relying on third-party apps or servers
 
-You can watch a [short video demonstrating Tella's main features here](https://vimeo.com/344220220/8c7f2fba67) (the video is from Tella for Android; most features are still to be completed for iOS)
+
+Tella:
+- encrypts photo, video, and audio files in a separate gallery so it cannot be accessed from the phone's regular gallery or file explorer.
+- allows users to quickly delete all files in Tella's encrypted Gallery.
+- enables users working with a group or organization to collect and send data to a server without relying on third-party apps or servers.
 
 ## Why Tella? <a id="why-tella"></a>
 
-Across the world, journalists and human rights defenders are facing increasing levels of physical repression, with mobile devices searched or seized at border crossings and airports, checkpoints, in the street, or in targeted raids. At the same time, digital surveillance and censorship threaten the flow of information out of repressive areas, particularly on violence, human rights abuse, or corruption. 
+Across the world, journalists and human rights defenders are facing increasing levels of physical repression, with mobile devices searched or seized at border crossings and airports, checkpoints, in the street, or in targeted raids. At the same time, digital surveillance and censorship threaten the flow of information out of repressive areas, particularly on violence, human rights abuse, or corruption.
 
-Tella's goal is to protect at-risk individuals and groups--advocates, journalists, human rights defenders--from repressive surveillance, whether physical or digital. Tella aims to provide a highly usable solution, accessible to all with minimal or no training, to collect, safeguard, and communicate sensitive information in highly repressive environments. 
+Tella's goal is to protect at-risk individuals and groups--advocates, journalists, human rights defenders--from repressive surveillance, whether physical or digital. Tella aims to provide a highly usable solution, accessible to all with minimal or no training, to collect, safeguard, and communicate sensitive information in highly repressive environments.
 
 Tella has three main objectives:
+
 - Protecting users who engage in documentation from physical and digital repression
 - Protecting the data they collect from censorship, tampering, interception, and destruction
 - Empowering individuals and groups to easily, quickly, and effectively collect data and produce high quality documentation that can be used for research, advocacy, or transitional justice
 
 Tella is used by:
-- Activists, organizers and human rights defenders to safely document events in their communities, produce reliable and verifiable evidence, and store data encrypted on their mobile devices
-- Media, professional reporters and citizen journalists to store sensitive media files encrypted as they travel, particularly as they cross borders
-- Civil society professionals and humanitarian workers to conduct interviews and collect data in poorly connected environments or in conflict areas
-- Electoral observation and monitoring organizations to monitor elections from inside and outside polling stations in real time and expose electoral fraud
-- Research institutions and international organizations to conduct research, interviews or surveys in challenging environments, particularly in conflict areas
 
-## Detailed list of features <a id="features"></a>
+- Activists, organizers and human rights defenders to safely document events in their communities, produce reliable and verifiable evidence, and store data encrypted on their mobile devices.
+- Media, professional reporters and citizen journalists to store sensitive media files encrypted as they travel, particularly as they cross borders.
+- Civil society professionals and humanitarian workers to conduct interviews and collect data in poorly connected environments or in conflict areas.
+- Electoral observation and monitoring organizations to monitor elections from inside and outside polling stations in real time and expose electoral fraud.
+- Research institutions and international organizations to conduct research, interviews or surveys in challenging environments, particularly in conflict areas.
 
-Below are the full list of features that will make up [Tella for iOS v1.0](https://github.com/Horizontal-org/Tella-iOS/milestone/1). Those features are already available in [Tella for Android](https://github.com/Horizontal-org/Tella-Android) but most haven't yet been developed for iOS.
+You can read [user stories here](https://tella-app.org/user-stories).
 
-### Encrypted container
-All of the content and data stored in Tella are encrypted. This means that unless the app is unlocked (using the 6-point pattern set up by the user upon installation), all the data will remain inaccessible to someone seizing or searching the device. Even if it is plugged into a computer and all of the device's data is extracted to be analyzed, all Tella content and data will look like gibberish and will be useless. Unlocking the app by entering the correct pattern is the only way to decrypt, and therefore read, the content stored in Tella.
 
-### Camouflage
-In order to protect the data produced and shared through Tella, the application and its content can be hidden on the user's device.
-The app's icon can be changed to a seemingly harmless one, such as a calcultor or a camera. This means that an individual searching the device will not see the Tella name and icon, and instead see an app that doesn't raise suspicions.
-WARNING: the name and icon of Tella will remain visible in the Android settings; this means that this camouflage will not protect against an individual actively looking for Tella or conducting an in-depth analysis of the device. This is a good protection against superficial searches of the user's device, avoiding to raise suspicions if an individual is quickly searching for incriminating evidence.
+## Detailed list of features <a id="features"></a>
 
-### Data collection
-Users working with an organization can upload photos, videos, and audio files, or fill and submit forms, to document events they are witnessing. The organization decides which method is most appropriate to their needs and capacity: receiving the files through a third-party app like WhatsApp or Signal; or using forms get ask questions about the specific data they need. 
+A detailed list of features for both Tella Android and iOS can be found [on the documentation](https://tella-app.org/features).
 
-Previous Tella deployments have ranged between 10 and 2,000 users. 
-Tella includes an "Offline Mode" for users who are collecting data in remote areas with limited or no internet connection. When Offline Mode is activated, all data is saved on the app and and users can submit it easily when they reach an internet connection.
 
-### Wipe data
-A Quick Delete button allows users, in a just a few seconds, to delete sensitive data within Tella. The button can also be set to delete the app itself.
+## How to get Tella and start using it? <a id="use-tella"></a>
 
-### Verification
-In the Tella settings, users can activate "Verification Mode". When activated, every time a user takes a photo or a video, or records audio, Tella automatically captures metadata about the file. This metadata can be used to corroborate evidence, cross check with other facts known about the event or about the area where it was captured.
+### Tella for iPhone
+Tella for iOS can downloaded [from the App Store](https://apps.apple.com/us/app/tella-document-protect/id1598152580).
 
-## How to get Tella and start using it? <a id="use-tella"></a>
+### Get started on Tella iOS
+A get started guide for Tella iOS is available [here](https://tella-app.org/get-started-ios).
 
-Tella is publicly available only on Android. You can [download it](https://play.google.com/store/apps/details?id=org.hzontal.tella) from the Google Play Store or [get the APK from here](https://web.tresorit.com/l/7737s#WKoGVN82C0lQK8KSL30CuA) to install manually on your device.
 
 ## Tech & frameworks used <a id="tech-used"></a>
-- [Secure Enclave](https://support.apple.com/guide/security/secure-enclave-overview-sec59b0b31ff/web) for security
+- [Secure Enclave](https://support.apple.com/guide/security/secure-enclave-overview-sec59b0b31ff/web) for security.
 - [SwiftUI](https://developer.apple.com/documentation/swiftui) for presenting views and interfaces
-- [PDFKit](https://developer.apple.com/documentation/pdfkit), [AVFoundation](https://developer.apple.com/documentation/avfoundation), and [QuickLook](https://developer.apple.com/documentation/quicklook) for previewing files in app
+- [AVFoundation](https://developer.apple.com/documentation/avfoundation), and [QuickLook](https://developer.apple.com/documentation/quicklook) for previewing files in app.
+- [Mantis](https://github.com/guoyingtao/Mantis) for [edit image feature](https://tella-app.org/features#edit-media). 
+- [GoogleSignIn](https://github.com/google/GoogleSignIn-iOS) and [GoogleAPIClientForREST/Drive](https://github.com/google/google-api-objectivec-client-for-rest) to implement [google drive connection](https://tella-app.org/g-drive)
+- [SQLCipher](https://github.com/sqlcipher/sqlcipher) for encrypted DataBase. 
+- [NextcloudKit](https://github.com/nextcloud/NextcloudKit) a package added to implement [Nextcloud connection](https://tella-app.org/nexcloud).
 
 
 ## Contributing to the code <a id="contributing"></a>
@@ -97,8 +96,19 @@ Tella is publicly available only on Android. You can [download it](https://play.
 
 **Step 6: Pushing your branch and creating a pull request** Push your branch up and create a pull request. Please indicate which issue your PR addresses in the title. 
 
+## Translating the app <a id="translating"></a>
+
+Tella is currently available in [17 languages](https://tella-app.org/translating-tella). We are always looking to translate Tella into more languages.
+
+If you are interested in adding a new language, or if you noticed a mistake or a missing translation, you can join [follow our contributing guidelines](https://tella-app.org/translating-tella/#how-do-i-become-a-translator).
+
+
+
 ## Contact us <a id="contact"></a>
-We love hearing from users, designers, and developers! If you have any question, ideas or suggestions on how we can improve or what new features we should add, or if you need support deploying Tella, don't hesitate to reach out!
+We love hearing from users, designers, and developers!
+
+We host monthly [community meetings](https://tella-app.org/community-meetings) and we offer different ways to [contact-us](https://tella-app.org/contact-us).
+
+If you have any question, ideas or suggestions on how we can improve or what new features we should add, or if you need support deploying Tella, don't hesitate to reach out!
 
-You can create an issue [here on our Github](https://github.com/Horizontal-org/Tella-iOS/issues) or email us at [email protected].