ACTF Contributors Information
Git Repository
The source code of the ACTF project can be found in the Git Repository. To access repository list, please visit " Developer Resources " tab of ACTF project page .
For more details to use Git in Eclipse, please visit EGit User Guide page.
Development Guidelines
1. Naming Conventions
Naming Conventions in the ACTF project follow the Eclipse Naming Conventions except for Java packages containing 'internal', 'tests', or 'examples'.
Java Packages
One of the main goals of this naming convention is to make it easy to find the component to which any given class belongs. The general form of java package names is as follows:
- org.eclipse.actf.<component>[.*]
Currently, ACTF includes the components listed below. This table also shows the subcomponents within each ACTF component.
| Group | Component name | Description |
|---|---|---|
| common | accservice | (deprecated) includes components for accessing native accessibility architectures and APIs |
| core | is reserved for future use | |
| model | includes components to support access to runtime properties of GUI components, document elements, and other runtime structures. It also includes typical application plugins as Editor Extensions. | |
| mediator | includes mediator services. | |
| repository | (deprecated) includes repository services. | |
| util | includes common utilities for other ACTF components. | |
| ai | ai | includes components for adaptive interfaces. |
| examples | examples | includes exemplary applications. |
| validation | validation | includes validation engine, rule manager, interfaces for and base implementations of rule sets and so on. |
| visualization | report | includes report generators. |
| visualization | includes accessibility/usability visualization engines. |
In the ACTF project, the reserved words 'internal', 'tests', or 'examples' may appear after the component name. For example, org.eclipse.actf.validation.tests indicates test cases that are used for the validation component. The preferred usage is to put the reserved names in the fifth position, leaving the fourth position for the component name. In addition to this, each component has its own ui components in the ACTF project. So, the word "ui" may appear after the component name as well.
The names of internal/tests/examples/ui packages in ACTF will be:
- org.eclipse.actf.<component>.internal[.*] - internal packages of <component>
- org.eclipse.actf.<component>.tests[.*] - test packages of <component>
- org.eclipse.actf.<component>.examples[.*] - examples of <component>
- org.eclipse.actf.<component>.ui[.*] - ui components of <component>
2. Coding conventions
The ACTF project uses the built-in Java-convention in Eclipse.
3. Namespace URI conventions
To avoid unexpected propagation, namespace URIs in ACTF project will be defined as follows:
- http://www.eclipse.org/projects/actf/<component>[/*]
If you need to create new namespaces, please submit a request to actf-dev mailing list .
4. APIs
In ACTF, all internal APIs are in internal packages and currently are not exported to others. (see also Naming Conventions )