Important

Please be sure to read about the major changes coming to the files on May 7, 2012 before doing anything here!

Welcome

We're getting older and our health isn't the best it's ever been, so increasingly the future of the Browser Capabilities Project will be in your hands. It will eventually be up to you to help keep the data for the project current and accurate; although hopefully our departure won't happen for a long time—still, it's always good to be prepared.

Collaboration

Our main goal here is to encourage collaboration on several files that form the core of the files. The hope is that even if we can no longer maintain the project ourselves—including production of all the files, and can't find anyone who wants to take ownership of the project, at least there could still be a browscap.ini file.

At the moment those "several files" consist of:

• browscap.ini
  A beta version of the core file that's used to create all the other files we collectively refer to as the files.
• devices.ini
  Used to create the DeviceName property.
• platforms.ini
  Used to create the Platform property.
• rendering-engines.ini
  Used to create the RenderingEngine_Name property.
• property-name-docs.ini
  Documentation for all of the properties used in the files.

Releases

Each new stable release of the files will be preceded by a tagged snapshot of the repository. The browscap.ini file in this snapshot will then be used to create the rest of the files. These tags will create a readily available and easy to use archive of previous releases, which is something we've always wanted but —apart from a recent attempt on the main website—never fully got around to doing.

The format for these kinds of tags is: browscap-<version>, where <version> is the version number.

Reporting Issues

Please use the Issues tracker here on GitHub to report any problems with the files. You can still report issues via our website, but doing it here means a greater chance it will get acted upon quickly.

Questions & Comments

We wish GitHub had a discussion group setup like the one we're using on Google Groups because then we'd keep everything on GitHub. But they don't, so we're using Google Groups to host our announcements and extended discussions. Please post your questions and comments there.

In Conclusion

Thanks in advance for whatever help you might offer.

~gary.