Development

.circleci/config.yml

@@ -3,16 +3,16 @@ jobs:
   build:
     working_directory: ~/code
     docker:
-      - image: circleci/android:api-30
+      - image: cimg/android:2024.01
     environment:
       JVM_OPTS: -Xmx3200m
     steps:
       - checkout
       - restore_cache:
           key: jars-{{ checksum "build.gradle" }}-{{ checksum  "app/build.gradle" }}
-#      - run:
-#         name: Chmod permissions #if permission for Gradlew Dependencies fail, use this.
-#         command: sudo chmod +x ./gradlew
+      #      - run:
+      #         name: Chmod permissions #if permission for Gradlew Dependencies fail, use this.
+      #         command: sudo chmod +x ./gradlew
       - run:
           name: Create local.properties
           command: touch local.properties
@@ -26,10 +26,9 @@ jobs:
       - run:
           name: Run Tests
           command: ./gradlew lint test
-      - store_artifacts: # for display in Artifacts: https://circleci.com/docs/2.0/artifacts/ 
+      - store_artifacts: # for display in Artifacts: https://circleci.com/docs/2.0/artifacts/
           path: app/build/reports
           destination: reports
       - store_test_results: # for display in Test Summary: https://circleci.com/docs/2.0/collect-test-data/
           path: app/build/test-results
       # See https://circleci.com/docs/2.0/deployment-integrations/ for deploy examples
-

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,17 +1,20 @@
 ---
 name: Bug report
 about: Create a report to document a bug in the app and to help us improve
-title: ''
+title: ""
 labels: bug
-assignees: ''
-
+assignees: ""
 ---
 
 **Describe the bug**
-A clear and concise description of what the bug is.
+A clear and concise description of what the bug is, who it affects, where it happens, and when it occurs.
+
+**Preconditions**
+Include any common configuration, users, or assumptions on how to reproduce.
 
 **To Reproduce**
-Steps to reproduce the behavior:
+Steps to reproduce the behavior.
+
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
@@ -20,13 +23,22 @@ Steps to reproduce the behavior:
 **Expected behavior**
 A clear and concise description of what you expected to happen.
 
+**Actual behaviour**
+Describe the error, flaw, or failure when interacting in more detail.
+
 **Screenshots**
 If applicable, add screenshots to help explain your problem.
 
+**Logs**
+If applicable, include any device logs.
+
 **Environment (please complete the following information):**
- - OS version: [e.g. Android 10]
- - Device: [e.g. Samsung Galaxy A2]
- - App Version [e.g. 2.2]
+
+- OS version: [e.g. Android 10]
+- Device: [e.g. Samsung Galaxy A2]
+- App Version [e.g. 2.2]
+- Backend(s): [e.g. Internet Archive, Nextcloud]
+- Component(s): [e.g. Onboarding, Settings]
 
 **Additional context**
-Add any other context about the problem here.
+Add any other context about the problem here. Please indicate priority and severity.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +1,70 @@
 ---
 name: Feature request
-about: Suggest an idea for this project. Please provide your feedback using the 'I
+about:
+  Suggest an idea for this project. Please provide your feedback using the 'I
   Like, I Wish, What if' feedback format
-title: ''
+title: ""
 labels: enhancement
-assignees: ''
-
+assignees: ""
 ---
 
-A preview of the [**I Like, I Wish, What if feedback format**](https://public-media.interaction-design.org/pdf/I-Like-I-Wish-What-If.pdf)
+A preview of the [**I Like, I Wish, What if feedback format**](https://public-media.interaction-design.org/pdf/I-Like-I-Wish-What-If.pdf) to fascilitate discussions.
 
 **I Like...**
+
 <!--(A clear and concise description of what you like about the prototype.)-->
 
 **I Wish...**
+
 <!--(A clear and concise description of how the prototype can be changed or improved so as to address some concerns or issues.)-->
 
 **What If...**
+
 <!--(Express new suggestions that might not have a direct link to the prototype.)-->
+
+---
+
+A preview of the **User Story format**
+
+## Motivation and Impact
+
+A clear reasoning of the value of the feature and why it should exist.
+
+**We believe** <!--(this capability)-->
+**Will result** <!--(this outcome)-->
+**We can proceed when** <!--(measurable signal)-->
+
+## User Story (High-Level Acceptance Criteria)
+
+A description of high-level outcomes for this feature as an end-user.
+
+As a _(type of user)_, I want _(some goal)_ so that _(some reason)_.
+
+Given _(precondition)_, when _(action)_, then _(outcome)_.
+
+## User Flow (optional)
+
+A step-by-step run-through of the user's journey with screenshots or mockups.
+
+## Functional Requirements and Developer Notes
+
+A technical discussion about the requirements with diagrams, schemas, or references.
+
+## Quality Assurance and Security Notes
+
+Describe what could go wrong with the system and how it would be handled.
+
+## Not in Scope, Questions, and Answers
+
+Mention aspects of the feature that are not in scope.
+Ask any remaining questions and answer known issues.
+
+## Acceptance Criteria
+
+A detailed list of rules that will consider this feature "done".
+
+## Affected
+
+Take note of any people, departments, users, platforms, or systems affected.
+
+Be sure to tag individuals or representatives.

.gitignore

@@ -1,3 +1,4 @@
+private-*
 openarchive-release.keystore
 
 # Built application files
@@ -43,9 +44,11 @@ proguard/
 app/releaseflavor/*
 
 # fastlane
+fastlane/metadata/*
 fastlane/report.xml
 fastlane/Preview.html
 fastlane/screenshots
 fastlane/test_output
 fastlane/README.md
-fastlane/.env
+fastlane/.env
+.env.default

Gemfile

@@ -0,0 +1,10 @@
+# Autogenerated by fastlane
+#
+# Ensure this file is checked in to source control!
+
+source "https://rubygems.org"
+
+gem 'fastlane'
+
+plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')
+eval_gemfile(plugins_path) if File.exist?(plugins_path)