Contents
Problem
- Too many overlapping pages.
- Too much info out of date.
- Too hard to find.
- Too hard to maintain.
Current State
GNOME Accessibility Developer Information (old) (svn)
"ATK" link (svn?)
"AT-SPI Documentation" link (svn?)
"HTML documentation of the IDL" link (under billh)
"Testing GNOME Applications for Accessibility" link - (svn?)
"GNOME Support" - (svn)
"Documentation" link - (svn?)
"API Reference" link - (svn?)
http://library.gnome.org/devel ("References" link)
http://library.gnome.org/devel/references ("References" link)
http://library.gnome.org/devel/references/gail-libgail-util/stable ("GAIL Reference Manual")
http://library.gnome.org/devel/at-spi-cspi/stable/ ("AT-SPI C Bindings References Manual")
http://library.gnome.org/devel/atk/stable/ ("ATK - Accessibility Toolkit")
...and so on.
Goals
- Provide a central "jumping off" point
- Cater to an audience of
- End users
- Developers interested in adding accessibility support to their apps and testing their apps for accessibility
- CTO's interested in switching to GNOME, also interested in learning more about accessibility in general
- OS distributions making sure they ship accessible systems
Plan
www.gnome.org
Just a jumping off point.
Create http://www.gnome.org/projects/accessibility (svn) - contains overview of what the accessibility project is about, links to specific docs on library.gnome.org, info on getting involved, news/events, presentations, screencasts, awards, etc. STATUS: track bug 558112.
Modify http://www.gnome.org/about "GNOME Accessibility Project" link to point to http://www.gnome.org/projects/accessibility (once it is created). STATUS: track bug 558112.
library.gnome.org
The primary source for docs generated/pushed from docbook sources under svn control.
User Docs
"GNOME Desktop Accessibility Guide" link points to generated/pushed docs from svn. STATUS: DONE!.
"GNOME Desktop Accessibility Guide" link probably should be moved under the "Accessibility" section. STATUS: TODO.
The "Accessibility" section contains pointers to the Dasher and MouseTweaks manuals. We need to include appropriate links to GOK, Orca, keyboard access, theming, AccessX, etc. STATUS: TODO.
Developer Docs
GUIDES: "GNOME Accessiblity Developers Guide" link to point to generated/pushed docs from svn. This not only contains info on developing apps, but also testing them for accessibility. STATUS: TODO.
- REFERENCE: Make sure the ATK, AT-SPI, and GAIL API reference guides are generated/pushed and up to date.
- DEVELOPMENT TOOLS: Cool. Accerciser is there. Rock and roll.
Administrator Docs
Put the new http://svn.gnome.org/viewvc/gnome-devel-docs/trunk/distro-testing-guide/ here?
- Put a link to the user docs for setting up accessible login?
live.gnome.org
- WIKI will be for GNOME accessibility developers to exchange/develop ideas and to work as a scratch pad.
- The WIKI should *not* be a source of documentation -- again it is a scratch pad.
Rearrange http://live.gnome.org/GAP and http://live.gnome.org/Accessibility over time to eliminate/redirect anything that stinks of documentation -- that stuff should all be under library.gnome.org.
Phase out http://live.gnome.org/GAP in favor of http://live.gnome.org/Accessibility.
developer.gnome.org
There were a bunch of pages and other stuff living here (svn). Users attempting to view these items/pages are now being redirected to current content. The old content (items listed here) has not yet been deleted. It looks like overall clean-up of cruft on developer.gnome.org is part of bug 549108.
http://developer.gnome.org/projects/gap/GNOME-Accessibility.html
http://developer.gnome.org/projects/gap/disability-types.html
http://developer.gnome.org/projects/gap/AT/Gnopernicus/index.html
http://developer.gnome.org/projects/gap/guide/gad/gad-api-examples.html
http://developer.gnome.org/projects/gap/guide/gad/gad-api.html
http://developer.gnome.org/projects/gap/guide/gad/gad-checklist.html
http://developer.gnome.org/projects/gap/guide/gad/gad-coding-guidelines.html
http://developer.gnome.org/projects/gap/guide/gad/gad-custom.html
http://developer.gnome.org/projects/gap/guide/gad/gad-overview.html
http://developer.gnome.org/projects/gap/guide/gad/gad-testing.htmll
http://developer.gnome.org/projects/gap/guide/gad/gad-ui-guidelines.html
http://developer.gnome.org/projects/gap/guide/gad/index.html
http://developer.gnome.org/projects/gap/sanity-testing/a11y_sanity_gnome_details.html
http://developer.gnome.org/projects/gap/sanity-testing/a11y_sanity_suite.html
http://developer.gnome.org/projects/gap/sanity-testing/index.html
http://developer.gnome.org/projects/gap/sanity-testing/sample-test-results.html
http://developer.gnome.org/projects/gap/testing/at-poke-test-cases.html
http://developer.gnome.org/projects/gap/testing/at-poke.html
http://developer.gnome.org/projects/gap/testing/festival-install.html
http://developer.gnome.org/projects/gap/testing/freetts-install.html
http://developer.gnome.org/projects/gap/testing/general-principles-test-cases.html
http://developer.gnome.org/projects/gap/testing/general-principles.html
http://developer.gnome.org/projects/gap/testing/gnopernicus-test-cases.html
http://developer.gnome.org/projects/gap/testing/gnopernicus.html
http://developer.gnome.org/projects/gap/testing/gok-test-cases.html
http://developer.gnome.org/projects/gap/testing/keyboard-navigation.html
http://developer.gnome.org/projects/gap/testing/keynav-test-cases.html
http://developer.gnome.org/projects/gap/testing/a11y_sanity_gnome_details.html
http://developer.gnome.org/projects/gap/testing/a11y_sanity_suite.html
http://developer.gnome.org/projects/gap/testing/simple-testing.html
http://developer.gnome.org/projects/gap/testing/testing.html
http://developer.gnome.org/projects/gap/testing/theme-compliance.html
http://developer.gnome.org/projects/gap/testing/theme-test-cases.html
http://developer.gnome.org/projects/gap/testing/tools-testing.html
http://developer.gnome.org/projects/gap/keynav/eel_lists.html
http://developer.gnome.org/projects/gap/keynav/gal_shortcut.html
http://developer.gnome.org/projects/gap/keynav/gnomeui_buttons.html
http://developer.gnome.org/projects/gap/keynav/gnomeui_dialogs.html
http://developer.gnome.org/projects/gap/keynav/gnomeui_lists.html
http://developer.gnome.org/projects/gap/keynav/gnomeui_text.html
http://developer.gnome.org/projects/gap/keynav/gtk_buttons.html
http://developer.gnome.org/projects/gap/keynav/gtk_containers.html
http://developer.gnome.org/projects/gap/keynav/gtk_lists.html
http://developer.gnome.org/projects/gap/keynav/gtk_menus.html
http://developer.gnome.org/projects/gap/keynav/gtk_numeric.html
http://developer.gnome.org/projects/gap/keynav/gtk_text.html
http://developer.gnome.org/projects/gap/keynav/gtk_tooltips.html
http://developer.gnome.org/projects/gap/keynav/other_lists.html
http://developer.gnome.org/projects/gap/keynav/panelnav.html
http://developer.gnome.org/projects/gap/tech-docs/ATK-docs.tar.gz
http://developer.gnome.org/projects/gap/tech-docs/SPI-IDL.tar.gz
http://developer.gnome.org/projects/gap/tech-docs/access-bugs-weekly.html
http://developer.gnome.org/projects/gap/tech-docs/access-bugs.html
http://developer.gnome.org/projects/gap/tech-docs/GTK-impl.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-accessible-objects.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-accessibleapplication-api.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-cspi-accessible-objects.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-cspi-registry-queries.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-cspi-state-and-statesets.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-event-listener-support.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/at-spi-registry-queries.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/book1.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/c5578.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/c5610.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/c5613.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/c5681.html
http://developer.gnome.org/projects/gap/tech-docs/at-spi-docs/c5682.html
http://developer.gnome.org/projects/gap/presentations/CSUN-2002-schedule.html
http://developer.gnome.org/projects/gap/presentations/GUAD3C/
http://developer.gnome.org/projects/gap/presentations/GUADEC/
http://developer.gnome.org/projects/gap/presentations/HKAA-2002/peter-korn-email.txt
http://developer.gnome.org/projects/gap/presentations/CSUN-slides-220301.tar.gz
http://developer.gnome.org/projects/gap/presentations/GUADEC-2004.sxi
http://developer.gnome.org/projects/gap/presentations/guadec.tar.gz
