Skip to content

Commit 62d0dab

Browse files
Merge pull request #77 from jimbethancourt/revert-readme-to-0.4.0
Reverting README.md
2 parents 6f79283 + 5b2d8ee commit 62d0dab

File tree

1 file changed

+6
-38
lines changed

1 file changed

+6
-38
lines changed

README.md

Lines changed: 6 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,13 @@ It runs PMD's God Class Rule and Coupling Between Objects rule and scans your Gi
66
The graphs generated in the report will look similar to this one:
77
![image info](./RefactorFirst_Sample_Report.png)
88

9-
## Please Note: Java 11 is now required to run RefactorFirst
10-
The change to require Java 11 is needed to address vulnerability CVE-2023-4759 in JGit
11-
Java 21 features are not yet integrated since PMD APIs have changed.
12-
139
## There are several ways to run the analysis on your codebase:
1410

1511
### From The Command Line
1612
Run the following command from the root of your project (the source code does not need to be built):
1713

1814
```bash
19-
mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.5.0-M1:report
15+
mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.4.0:report
2016
```
2117

2218
### As Part of a Build
@@ -28,7 +24,7 @@ Add the following to your project in the build section. **showDetails** will sh
2824
<plugin>
2925
<groupId>org.hjug.refactorfirst.plugin</groupId>
3026
<artifactId>refactor-first-maven-plugin</artifactId>
31-
<version>0.5.0-M1</version>
27+
<version>0.4.0</version>
3228
<!-- optional -->
3329
<configuration>
3430
<showDetails>true</showDetails>
@@ -39,50 +35,23 @@ Add the following to your project in the build section. **showDetails** will sh
3935
</build>
4036
```
4137

42-
### As a Maven Report
38+
### As a Report
4339
Add the following to your project in the reports section.
40+
Not supported as of Version 0.2.0 due to CVE-2020-13936
4441
```xml
4542
<reporting>
4643
<plugins>
4744
...
4845
<plugin>
4946
<groupId>org.hjug.refactorfirst.plugin</groupId>
5047
<artifactId>refactor-first-maven-plugin</artifactId>
51-
<version>0.5.0-M1</version>
48+
<version>0.1.1</version>
5249
</plugin>
5350
...
5451
</plugins>
5552
</reporting>
5653
```
5754

58-
If you see an error similar to
59-
```
60-
Execution default-site of goal org.apache.maven.plugins:maven-site-plugin:3.3:site failed: A required class was missing while executing org.apache.maven.plugins:maven-site-plugin:3.3:site: org/apache/maven/doxia/siterenderer/DocumentContent
61-
```
62-
you will need to add the following to your pom.xml:
63-
```xml
64-
<build>
65-
<plugins>
66-
<plugin>
67-
<groupId>org.apache.maven.plugins</groupId>
68-
<artifactId>maven-site-plugin</artifactId>
69-
<version>3.12.1</version>
70-
</plugin>
71-
<plugin>
72-
<groupId>org.apache.maven.plugins</groupId>
73-
<artifactId>maven-project-info-reports-plugin</artifactId>
74-
<version>3.4.5</version>
75-
</plugin>
76-
</plugins>
77-
</build>
78-
```
79-
80-
### As an HTML Report
81-
```bash
82-
mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.5.0-M1:htmlReport
83-
```
84-
View the report at ```target/site/refactor-first-report.html```
85-
8655
## But I'm using Gradle / my project layout isn't typical!
8756
I would like to create a Gradle plugin and (possibly) support non-conventional projects in the future, but in the meantime you can create a dummy POM file in the same directory as your .git directory:
8857

@@ -99,11 +68,10 @@ I would like to create a Gradle plugin and (possibly) support non-conventional p
9968
and then (assuming Maven is installed) run
10069

10170
```bash
102-
mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.5.0-M1:htmlReport
71+
mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.4.0:report
10372
```
10473

10574
## Viewing the Report
106-
View the report at ```target/site/refactor-first-report.html```
10775
Once the plugin finishes executing (it may take a while for a large / old codebase), open the file **target/site/refactor-first-report.html** in the root of the project. It will contain a graph similar to the one above, and a table that lists God classes in the recommended order that they should be refactored. The classes in the top left of the graph are the easiest to refactor while also having the biggest positive impact to team productivity.
10876
If highly coupled classes are detected, a graph and table listing Highly Coupled Classes in will be generated.
10977

0 commit comments

Comments
 (0)