This project provides a Java-based tool for calculating the Gunning Fog Index of software documentation. The Gunning Fog Index is a readability test that estimates the years of formal education or the minimum age a full-time student needs to understand a text on the first reading. This tool is specifically tailored to analyze the readability of software-related documents, making it an essential utility for technical writers, software developers, and project managers.
- Read text files containing software documentation.
- Calculate the Gunning Fog Index to assess readability.
- Handle various types of software documentation, from user guides to technical API documents.
- Java JDK 8 or higher
- Clone the repository to your local machine.
- Navigate to the cloned directory.
- Compile the Java program.
- Place your software documentation text files in the
docs
directory. - Run the program with the filename as an argument.
- The program will output the Gunning Fog Index for the provided document.
Contributions to this project are welcome. To contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/AmazingFeature
). - Commit your changes (
git commit -m 'Add some AmazingFeature'
). - Push to the branch (
git push origin feature/AmazingFeature
). - Open a pull request.
Matheus K. Westphalen - [email protected]
Nicole Edoziem - [email protected]
Project Link: https://github.com/mwestphalen/gunning-fog-index-calculator