Skip to content

Commit 610ef5f

Browse files
committed
updated
1 parent 26189d1 commit 610ef5f

File tree

3 files changed

+29
-15
lines changed

3 files changed

+29
-15
lines changed

README.md

Lines changed: 23 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,23 @@
1-
# Project Sunshine
2-
_[working name]_
3-
4-
This project is related to the identifier rename tool.
5-
6-
- ## Anti-Pattern Rules
7-
- ### [Arnaoudova et al.](http://veneraarnaoudova.com/wp-content/uploads/2014/10/2014-EMSE-Arnaodova-et-al-Perception-LAs.pdf)
8-
- ### [SCANL](documentaion/AntiPatternRules_SCANL.md)
9-
10-
- ## Implementation Status
11-
- ### [Arnaoudova et al.](documentaion/AntiPatternStatus_Arnaoudova.md)
12-
- ### [SCANL](documentaion/AntiPatternStatus_SCANL.md)
1+
# IDEAL
2+
3+
#### _An Open-Source Identifier Name Appraisal Tool_
4+
5+
### Abstract
6+
7+
Developers must comprehend the code they will maintain, meaning that the code must be legible and reasonably
8+
self-descriptive. Unfortunately, there is still a lack of research and tooling that supports developers in understanding
9+
their naming practices; whether the names they choose make sense, whether they are consistent, and whether they convey
10+
the information required of them. In this paper, we present IDEAL, a tool that will provide feedback to developers about
11+
their identifier naming practices. Among its planned features, it will support linguistic anti-pattern detection, which
12+
is what will be discussed in this paper. IDEAL is designed to, and will, be extended to cover further anti-patterns,
13+
naming structures, and practices in the near future. IDEAL is open-source and publicly available, with a demo video
14+
available at: [https://youtu.be/fVoOYGe50zg](https://youtu.be/fVoOYGe50zg)
15+
16+
### Setup and Use
17+
18+
Details around setting up and using IDEAL are available [here](documentaion/SetupAndUse.md).
19+
20+
21+
### Naming Violations
22+
- ### [Arnaoudova et al.](documentaion/AntiPatternRules_Arnaoudova.md)
23+
- ### [SCANL](documentaion/AntiPatternRules_SCANL.md)

documentaion/SetupAndUse.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,3 +69,6 @@ C. [Configure and Run IDEAL For Project](#Configure-and-Run-IDEAL-For-Project)
6969
5. Results saved in IDEAL_Results.csv file
7070

7171
<img src="images\setup\results.png" style="zoom:40%;" />
72+
73+
74+
##### [Back To ReadMe](../README.md)

documentaion/ToolDetails.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,10 @@ This document provides details (functional and technical) around our linguistic
3333
- Part-of-Speech tagging - Stanford tagger (4.2.0)
3434

3535

36-
37-
38-
3936
## References
4037

4138
[1] Arnaoudova, V., Di Penta, M., & Antoniol, G. (2016). Linguistic antipatterns: What they are and how developers
4239
perceive them. Empirical Software Engineering, 21(1), 104-158.
40+
41+
42+
##### [Back To ReadMe](../README.md)

0 commit comments

Comments
 (0)