docs(): fix readme and audit

add prints

subjects/mobile-dev/map-markers/README.md

@@ -1,38 +1,67 @@
 ## map-markers
 
-### Introduction
+In this project, your team will create an app that uses the `Google Maps API`. The app must allow users to save and display their favorite places on a map.
 
-Create an app where you can save the list of your favorite places and show them in the app.
+### Instructions
 
-In this raid, your team should implement an app which uses google maps.
+The app should have the following functionality:
 
-### Objective
+A `TabBar` with three screens:
 
-Implement following functionality:
+- A `Maps` screen like [google maps](https://codelabs.developers.google.com/codelabs/google-maps-in-flutter#0) where the user can see their favorite places marked on the map with an `info view`.
 
-- Tabbar app with 3 screens:
+- A `favorite places` screen which will have a list of the user's favorite places.
-  - Google maps screen [example](https://codelabs.developers.google.com/codelabs/google-maps-in-flutter#0)
-  - List of your favorite places.
-  - Info about your app. Names of the authors, their email adresses, and general description of what your application does.
 
-On map there must be:
+- An `InfoPage` screen that displays the names and email addresses of the app's authors, along with a general description of the app.
 
-- Your favorite places as markers (with infoView) (places must be saved after reopenig the app)
+**On the Map screen:**
-- When some place is tapped, open dialog window with title and description textfields
-- A button, which will navigate to current position of device
-- Search bar to search for addresses, places, use google places API. When suggested address is tapped on, navigate map to that place
 
-On FavouritesList Screen:
+- The user's favorite places should be displayed as `markers` on the map (with an info view) and saved so that they persist after the app is closed.
+- When a `marker` is tapped, a dialog window should open displaying the place's title/name.
+- A button should be provided to navigate to the user's current location.
+- A search bar needs to be included in order to allow the user to search for addresses and places, you can use the `Google Places API`. When a suggested address is tapped, the map should navigate to that place.
 
-- List of favorite places, which you can delete
+<center>
+<img src="./resources/map.png?raw=true" style = "width: 210px !important; height: 420px !important;"/>
+<img src="./resources/favorite-in-map.png?raw=true" style = "width: 210px !important; height: 420px !important;"/>
+<img src="./resources/search.png?raw=true" style = "width: 210px !important; height: 420px !important;"/>
+</center>
 
-On InfoPage Screen:
+**On the Favorite Places screen:**
 
-- Your names as developers, year, etc
+- The user's list of favorite places should be displayed and the user should be able to delete them.
+<center>
+<img src="./resources/favorites.png?raw=true" style = "width: 210px !important; height: 420px !important;"/>
+<img src="./resources/delete.png?raw=true" style = "width: 210px !important; height: 420px !important;"/>
 
-- Note: don't forget about info.plist:
+Here when the user slides it to the right it deletes the favorite place.
 
+</center>
+
+**On the Info screen:**
+
+- The names and email addresses of the app's developers should be displayed, along with the year of development and any other relevant information.
+
+<center>
+<img src="./resources/infopage.png?raw=true" style = "width: 210px !important; height: 420px !important;"/>
+</center>
+
+### Hints
+
+> Here is how to get your [Google Maps API key](https://blog.logrocket.com/google-maps-flutter/) and use it.
+
+> Note: Don't forget to add the following to your `AndroidManifest.xml` file as well as your API key:
+
+```xml
+<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
 ```
-NSLocationWhenInUseUsageDescription
+
-NSLocationAlwaysUsageDescription
+> Note: Don't forget to add the following to your `info.plist` file as well as your API key in `AppDelegate.swift`:
+
+```xml
+<key>NSLocationWhenInUseUsageDescription</key>
+<key>NSLocationAlwaysUsageDescription</key>
 ```
+
+These entries are required in order to use the device's location services.

subjects/mobile-dev/map-markers/audit/README.md

@@ -1,35 +1,37 @@
 #### Functional
 
-> In order to run and hot reload app either on emulator or device, follow the [instructions](https://docs.flutter.dev/get-started/test-drive?tab=androidstudio#run-the-app)
+> In order to run and hot reload the app either on emulator or device, follow the [instructions](https://docs.flutter.dev/get-started/test-drive?tab=androidstudio#run-the-app)
 
-###### Does the application run without crashes?
+###### Does the app run without crashing?
 
-###### Does the application have Bottom tabbar?
+###### Does the app have `Bottom TabBar`?
 
-###### Does the application show google maps?
+###### Does the app show google maps on the `Map` screen?
 
-###### Does the application show list of favorite places?
+###### Does the app show the list of favorite places on the `Favorite Places` screen?
 
-###### Does the application show list of favorite places after reopening application?
+###### Does the app show the list of favorite places after closing and reopening the app?
 
-###### Does the application contain an information page?
+###### Can you delete a favorite place from your list?
 
-###### Does map show markers with favorite places?
+###### If the favorite place is deleted, does the app remove it from the map?
 
-###### When map is tapped, does dialog window show 2 textfields: name and description?
+###### Does the app contain an information page on the `Info` screen?
 
-###### Does the application have current location button. If so, does it lead you to your current place?
+###### Does the map show markers at your favorite places?
 
-###### Does the application have searchbar?
+###### When the map is tapped, the dialog window shows the `title/name` of the place?
 
-###### Tap the searchbar. Does the application show list of suggestions?
+###### Does the app have a button to return to current location?
 
-###### Tap an item in suggestion list. Does the map navigate to place?
+###### Does the return to current location button take you to your current location?
 
-###### Can you delete a place from favorites places list?
+###### Does the app have a searchbar on the `Map` screen?
 
-###### Delete place from list. Does the application remove it from map?
+###### Does the app show a list of suggestions when you tap the searchbar?
 
-###### Does the application work both on android and ios?
+##### Tap an item in the searchbar suggestion list.
 
-###### Tap on marker. Do you see relevant information about the place?
+###### Does the map navigates to the tapped place?
+
+###### Does the app work both on android and ios?