Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update AboutUs, ContactUs, UserGuide, DeveloperGuide, FileName.java and FileNameTest.java #117

Merged

Conversation

JonathanLeeWH
Copy link

@JonathanLeeWH JonathanLeeWH commented Mar 24, 2019

Update AboutUs.adoc with updated Github project url
Update ContactUs.adoc with improved description and updated Github project url
Update UserGuide.adoc with improved Introduction section description, improved Exporting as CSV file format description, ensure consistency, updated Github project url
Update DeveloperGuide.adoc with updated prerequisites which recommend JDK 9 with a note on why JDK 11 and later are not supported/recommended, improved description for setting up the project, ensure consistency, update package url for commons with the correct package url, updated section headers for consistency and updated Exporting to CSV file format description with ExportCommandActivityDiagram.png.
Upload ExportCommandActivityDiagram.png
Update FileName.java with improved FileName.java class description to include more detailed information on File Naming Conventions including certain platform unique restrictions and suggestions on what Java build in classes which can complement with this class to help solve potentially platform unique issues involving file names
Improve isValidFileName() method's String parameter name to be more descriptive
Add requireNonNull() check in the isValidFileName() method implementation to ensure that the argument passed to isValidFileName parameter is non null
Update FileName.java description with reserved names which are not allowed in Windows as file names with the relevant documentations to explain why they are not allowed
Add a new constant String variable RESERVED_NAMES_REGEX which contains the regex pattern to check for reserved names which are not allowed as file names in Windows based on Windows documentation.
Include additional reserved names not allowed by Windows but not included in Windows documentation: COM0 and LPT0 (These were found based on personal manual testing on Windows 10)
Add additional JUnit test cases to test for the reserved names not allowed by Windows as file names in FileNameTest.java
These updates to FileName.java and FileNameTest.java is to ensure portability, in other words, making the file name validation platform independent

Update the Github project url
Fix formatting
Update Github url
Improve description in ContactUs.adoc
Update UserGuide.adoc for consistency
Update DeveloperGuide.adoc for consistency
Improve description for the export command
Improve Introduction description
Improve Exporting as CSV file format description
Update Github url
Update package url for commons with the correct package url
Update DeveloperGuide.adoc who updated prerequisites which recommends JDK 9 with a note on why JDK 11 and later are not supported/recommended
Improve description for setting up the project
Ensure consistency in DeveloperGuide.adoc
Update Section Headers in DeveloperGuide.adoc to ensure consistency
Update DeveloperGuide.adoc Export command Description to ensure consistency
Upload ExportCommandActivityDiagram.png for Export Command Implementation description in DeveloperGuide.adoc
Update DeveloperGuide.adoc Exporting to CSV file format description
Update export command description to include ExportCommandActivityDiagram.png
Improve FileName.java class description to include more detailed information on File Naming Conventions including certain platform unique restrictions and suggestions on what Java build in classes which can complement with this class to help solve potentially platform unique issues involving file names
Improve isValidFileName() method's String parameter name to be more descriptive
Add requireNonNull() check in the isValidFileName() method implementation to ensure that the argument passed to isValidFileName parameter is non null
Update FileName.java description with reserved names which are not allowed in Windows as file names with the relevant documentations to explain why they are not allowed
Add a new constant String variable RESERVED_NAMES_REGEX which contains the regex pattern to check for reserved names which are not allowed as file names in Windows based on Windows documentation.
Include additional reserved names not allowed by Windows but not included in Windows documentation: COM0 and LPT0 (These were found based on personal manual testing on Windows 10)
Add additional JUnit test cases to test for the reserved names not allowed by Windows as file names in FileNameTest.java
These updates to FileName.java and FileNameTest.java is to ensure portability, in other words, making the file name validation platform independent
@JonathanLeeWH JonathanLeeWH added type.Enhancement An enhancement to an existing story type.Task Something that needs to be done, but not a story, bug, or an epic. e.g. Move testing code into a new v1.3 For v1.3 project milestone labels Mar 24, 2019
@JonathanLeeWH JonathanLeeWH added this to the v1.3 milestone Mar 24, 2019
@JonathanLeeWH JonathanLeeWH self-assigned this Mar 24, 2019
@JonathanLeeWH JonathanLeeWH added this to To do in Export Command Feature via automation Mar 24, 2019
Update ExportCommandActivityDiagram.png
Export Command Feature automation moved this from To do to In progress Mar 24, 2019
Copy link

@flxffy flxffy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very thorough documentation!

@JonathanLeeWH JonathanLeeWH merged commit f707a76 into CS2103-AY1819S2-T12-3:master Mar 24, 2019
Export Command Feature automation moved this from In progress to Done Mar 24, 2019
@JonathanLeeWH JonathanLeeWH deleted the update-developer-guide branch March 24, 2019 04:43
@JonathanLeeWH JonathanLeeWH changed the title Update AboutUs, ContactUs, UserGuide, DevelopeGuide, FileName.java and FileNameTest.java Update AboutUs, ContactUs, UserGuide, DeveloperGuide, FileName.java and FileNameTest.java Mar 25, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type.Enhancement An enhancement to an existing story type.Task Something that needs to be done, but not a story, bug, or an epic. e.g. Move testing code into a new v1.3 For v1.3 project milestone
Projects
Development

Successfully merging this pull request may close these issues.

None yet

2 participants