/Naming Convention.md (4563cd5d189f7973174746e5c2e28ebc0a6ec196) (4139 bytes) (mode 100644) (type blob)
# Naming Convention Standard/File Name Conventions
### A collection of guidelines for writing file, folder, classes, figures, and images names in the project. These guidelines should help you toward that goal of not only correct code, but understandable.
* Our working directory is

* [File Names](#file-name)
* [Figures](#figure-name)
* [Folders](#folder-name)
* [The Tags in the Document](#tag-name)
* [The Links in the Document](#link-name)
* [Code Folder Naming Convention](#code-folder-naming-convention)
# Code Folder Naming Convention
### In code Folder, we have following folders
1. [JAVA](#java)
2. [SQL](#sql)
3. [XML](#xml)
#### JAVA
* JAVA Files in Code Folder.
* Every JAVA file name will be written as UpperCamelCase.
* Words are smashed together and the first letter of each word is capitalized. No word separator, like the underscore _, is used.
| Example | FileName.java |
| ----------- | ------------- |
* If there is any version/number, it should be written as,
| Example | FileName01.java | FileName02.java |
| ----------- | --------------- | --------------- |
* Classes and Interfaces Names
* Class and interface names are generally noun or noun phrases.
* Class and interface must begin with a capital letter.
|interface Example | interface AqueousHabitat { ... } |
| -------------------- | -------------------------------- |
|Class Example | class FishBowl implements AqueousHabitat { ... } |
| -------------------- | ------------------------------------------------ |
* Variables : Variable names should be short yet meaningful.
* Should not start with underscore(‘_’) or dollar sign ‘$’ characters.
* Should be mnemonic i.e, designed to indicate to the casual observer the intent of its use.
* One-character variable names should be avoided except for temporary variables.
* Common names for temporary variables are i, j, k, m, and n for integers; c, d, and e for characters.
| Example | int speed = 0 | int gear = 1; |
| ----------- | ----------- | ----------- |
* Constant variables:
* Should be all uppercase with words separated by underscores (“_”).
* There are various constants used in predefined classes like Float, Long, String etc.
| Example | static final int MIN_WIDTH = 4; |
| ----------- | -------------------------------- |
#### SQL
* SQL folder has Homework Files.
* Every Homework will be followed by HW_ and filename.
| Example | HW_HomeworkName |
| -----------| --------------- |
#### XML
* XML Files in Code Folder
* Camel case is a common naming rule in JavaScripts.
* Uppercase first letter in each word except the first
| Example | firstName |
| ----------- | ---------- |
# File Name
* Make file names lowercase.
* Separate words with underscores.
* Use only standard ASCII alphanumeric characters in file and directory names.
* Recommended
Example | file_name.extension |
---------|---------------------|
# Folder Name
* Folder Name should be meaningful.
* Make folder names lowercase.
# Figure Name
* Figures Names should follow the Underscore Case.
* everything is in lower case and the words are separated by underscores.
* This convention is also popularly known as snake case.
| Example | figure_name.svg |
| ---------- | --------------- |
# Tag Name
# Link Name
##### *Important* Notes:
* Do not use names which could misguide other developers.
* Names should be meaningfully distinct and pronounceable.
### *Rules* are taken by:
* https://www.geeksforgeeks.org/.
* https://www.w3schools.com/xml/xml_elements.asp.
* https://developers.google.com/style/filenames.
* https://guides.lib.purdue.edu/c.php?g=353013&p=2378293
* https://dev.to/danialmalik/a-beginner-s-guide-to-clean-code-part1-naming-conventions-139l
* https://www.cs.cornell.edu/courses/JavaAndDS/JavaStyle.html
Mode |
Type |
Size |
Ref |
File |
100644 |
blob |
66 |
dfe0770424b2a19faf507a501ebfc23be8f54e7b |
.gitattributes |
100644 |
blob |
24533 |
e0254f6b47042e5870aff0f206c55f907bff3ef5 |
1.png |
100644 |
blob |
2004 |
bc812ab8cb5f7c667981a30e936d7cf44fd20cae |
CONTRIB.md |
100644 |
blob |
17391 |
ee4f999692dd06cb3fb247c76961eb937a4b61f8 |
KNOWN_BUGS.md |
100644 |
blob |
17370 |
88336d7c15e68de644f6ece046e4ed3a2fa6d563 |
LICENSE.md |
100644 |
blob |
4139 |
4563cd5d189f7973174746e5c2e28ebc0a6ec196 |
Naming Convention.md |
100644 |
blob |
4342 |
27500c73cdde3d30d803760f78a1e2b5d2b0b096 |
README.md |
100644 |
blob |
977 |
588857854369059aedc86cfc40b7dfce0d9b9b07 |
TO_DO.md |
100644 |
blob |
2675 |
4bc53f72a0bf4d859a0bc8cf7a7cb65c5fe751f0 |
WORKFLOW.md |
040000 |
tree |
- |
7c8169dc2a61ede5ae3bd4b3171514b4ded52c81 |
install |
040000 |
tree |
- |
5cc161fd544e2cb8e5d8cd32da0d067a353066a7 |
notes |
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/caubert/CSCI_3410
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/caubert/CSCI_3410
Clone this repository using git:
git clone git://git.rocketgit.com/user/caubert/CSCI_3410
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a
merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main