kaloyan-raev / eclipse-ui-tips Goto Github PK

Currently, the text fills entirely the horizontal space without having any margins. Adding margins would improve readability.

The root of the git repo should contain a README file with overview of the project and instructions how to install and use it.

The master part should display a list of all categories.
The details part should display a list of the guidelines in the selected category.

When the guideline activity is displayed, users shall be able to browse through all the guidelines by swiping left and right.

Add About section. It should give the follwing info:

1. Short info and link to the project.
2. License
3. Attribution to http://glyphicons.com/

Based on a feedback in Google Play.

There should be an additional preference that enables users to configure the time which the "tip of the day" notification is fired at.

When viewing a guideline, users may decide to change the app preferences, e.g. switch off tips of the day.
An appropriate way (e.g. menu item) should be available in the activity that displays guidelines.

Steps to reproduce:

1. Wait for a notification.
2. Tap on it to show the guideline in the activity.
3. Keep the activity open while waiting for another notification.
4. Tap on the new notification.
5. The focus switches to the activity, but the old guideline is still displayed.

For some reason the notification appears about 5-10 minutes after the alarm is scheduled for, e.g. if the alarm is set to 8:30 am, then the notification fires at 8:37 am or 8:38 am.

We set a repeating alarm in the AlarmManager in order to fire notifications. Unfortunately, if the device is restarted the registration in the AlarmManager is cleared and has to be set again.

We can hook to the BOOT_COMPLETED event to register the alarm again. Details: http://stackoverflow.com/questions/1869989/android-alarmmanager-recovery

Based on feedback in Google Play.

Usability issues As much fun it might be to be presented with an UI tip every morning (time unfortunately not configurable) it would be much more useful if on could simply browse the UI tips in the app. As of now the app only shows the preference screen and is pretty useless.

The action bar should be available for all supported Android versions. There is a nice compatibility library available: http://actionbarsherlock.com/

The action bar icon should implement Up Navigation: http://developer.android.com/design/patterns/navigation.html

Currently, the status bar notification icons follow the design for ICS (Android 4.x). However, it does not look well on devices running an older version of the platform. The icons should be available in the proper style for all of the supported version of the platform.

http://developer.android.com/guide/practices/ui_guidelines/icon_design_status_bar.html
http://developer.android.com/design/style/iconography.html

There is a nice set of icons available at http://glyphicons.com/ that can be used for the application. Especially, there is an excellent "dice" icon that can replace the current one.

All source files should include copyright header.

EPL guidelines: http://www.eclipse.org/legal/copyrightandlicensenotice.php

The notification alarm is registered for recurring in a daily interval. The daily interval actually means exactly 24 hours. If the time zone changes then the notification will fire in completely different time than expected. Same is valid if the system clock time is changed significantly.

The app should catch an appropriate event and reset the alarm.

http://stackoverflow.com/questions/5481386/date-and-time-change-listener-in-android
http://www.ceveni.com/2011/03/how-to-get-timezone-change-event-in.html

The root of the git repo should contain a LICENSE file.

Currently, the app uses the default theme for Android 2.2 - white text on black screen. This is regardless the actual version of the Android platform the application is running on.

The application should use the default theme for the version of the platform it actually is installed on.

Add a button in the action bar that jumps to the next random guideline.

The Eclipse Juno launch icon looks like. It could be used as a basis for application icon.

Currently, the app uses the default theme for Android 2.2 - white text on black screen.
Readability would be improved by changing the theme to Holo Light - the one used by apps like Google Maps, Google Mail, Google Reader, etc.

http://developer.android.com/design/style/themes.html

The user should have the option to disable the notifications if she wants to take rest of the Eclipse UI Guidelines.
In fact, notifications should be disabled by default.

The welcome activity seems to be a good place for a checkbox that enables/disables notifications.

When running the application in a tablet emulator (API 12) it crashes with the following exception:

06-26 15:15:33.114: E/AndroidRuntime(410): android.app.RemoteServiceException: Bad notification posted from package name.raev.kaloyan.android.eclipseuitips: Couldn't attach StatusBarIcon: StatusBarIcon(pkg=name.raev.kaloyan.android.eclipseuitips id=0x7f020001 level=0 visible=true num=0 )

The project has now dependency to a 3rd party library - ActionBarSherlock. Mavenizing the project will simplify the environment setup and the build.

When user starts the application, there should be a way to start browsing through the guidelines. A quick start could be from a random guideline.

There should be a link on the welcome screen that jumps to a random guideline.