Maps SDK: Inaccurate or unclear instruction after recent refactoring

[antonsurya]

Environment details

• Android Studio: Otter 3 Feature Drop (version 2025.2.3)
• OS: MacOS 15.7.3
• Commit: https://github.com/googlemaps-samples/android-samples/releases/tag/v2.0.0

Problems

I believe recent changes, perhaps the refactoring in #2345, caused some instructions in this repo inaccurate or unclear.

Examples:

Example 1: which directory to open in Android Studio

android-samples/README.md

Line 44 in e4ea31a

1. Select one of the sample directories from this repository

1. Download the samples by cloning this repository
2. In the welcome screen of Android Studio, select "Open an Existing project"
3. Select one of the sample directories from this repository

Previously, in the third step developers should choose a directory like android-samples/ApiDemos.

Now, they need to choose the top directory i.e. android-samples.

Example 2: where to put file secrets.properties

android-samples/ApiDemos/project/kotlin-app/build.gradle.kts

Line 106 in e4ea31a

// 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.

Previously, developers needed to create secrets.properties file under each project, e.g. android-samples/ApiDemos/project.

Now, developers need to create the file in the top directory, i.e. android-samples.

[kikoso]

Thanks for the heads-up, @antonsurya . This PR should update the documentation

#2352