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

Improve Javadoc Comments #2

Open
ajaynegi45 opened this issue Sep 29, 2024 · 11 comments
Open

Improve Javadoc Comments #2

ajaynegi45 opened this issue Sep 29, 2024 · 11 comments
Assignees
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers hacktoberfest hacktoberfest-accepted status: ready for dev You can asked for this issue to be assigned (if not already assigned)

Comments

@ajaynegi45
Copy link
Owner

Description:
The current Javadoc comments in the Http-Server project can be improved to enhance clarity and provide more beginner-friendly explanations. This will help new contributors better understand the code and contribute more easily.

Tasks:

  1. Review the existing Javadoc comments across all classes and methods.
  2. Simplify technical jargon and provide clear explanations.
  3. Add examples where necessary to demonstrate how methods and classes are used.
  4. Ensure consistency in formatting and language throughout the codebase.
  5. Follow best practices for writing Javadoc comments:
    • Briefly describe the purpose of the class or method.
    • Explain all parameters and return values.
    • Highlight any exceptions thrown by the method.
    • Include relevant tags (e.g., @param, @return, @throws).

Requirements:

  • Basic knowledge of Java and Javadoc format.
  • Willingness to make the comments approachable for beginners.

Additional Notes:
Feel free to ask any questions or request clarifications in the comments below. Let's make this project more accessible to new contributors! 😊

@ajaynegi45 ajaynegi45 added documentation Improvements or additions to documentation good first issue Good for newcomers hacktoberfest hacktoberfest-accepted status: ready for dev You can asked for this issue to be assigned (if not already assigned) labels Sep 29, 2024
@mr-panther01
Copy link

If you want I can contribute to this issue

@ajaynegi45
Copy link
Owner Author

If you want I can contribute to this issue

Hi @mr-panther01,

Thank you for expressing your interest in working on this issue. I'm delighted to inform you that I have assigned this issue to you. Your willingness to contribute to our project is much appreciated.

Before making any contributions, please read the Readme.md file carefully to better understand the project's goals and purpose. This will give you clarity on our mission. Also, make sure to review the Contributing.md file, which contains important guidelines to make the contribution process smoother, especially for newcomers.

Feel free to start working, and if you have any questions or need assistance during the process, please don't hesitate to reach out.

@mr-panther01
Copy link

Thank you so much for assigning this issue I assure you that you will get the best output from me

@Ambit-ion
Copy link

Hey, I'm a newbie, is this issue still open? I want to learn and contribute and if not is there any other basic good first issue? I am new to open source world but I have always been fascinated by open source .

@ajaynegi45
Copy link
Owner Author

Hey, I'm a newbie, is this issue still open? I want to learn and contribute and if not is there any other basic good first issue? I am new to open source world but I have always been fascinated by open source .

Hi @Ambit-ion,

Thank you for expressing your interest in working on this issue. However, this issue is currently being worked on by another contributor, @mr-panther01. You can explore other issues in our repository or check out our other projects under the GirlScript Summer of Code and Hacktoberfest.

Here are the links to explore:

https://bento.me/codiescoder

Feel free to reach out if you have any questions or need guidance on where to start. We're excited to have your contributions!

@Ambit-ion
Copy link

Hey, I'm a newbie, is this issue still open? I want to learn and contribute and if not is there any other basic good first issue? I am new to open source world but I have always been fascinated by open source .

Hi @Ambit-ion,

Thank you for expressing your interest in working on this issue. However, this issue is currently being worked on by another contributor, @mr-panther01. You can explore other issues in our repository or check out our other projects under the GirlScript Summer of Code and Hacktoberfest.

Here are the links to explore:

https://bento.me/codiescoder

Feel free to reach out if you have any questions or need guidance on where to start. We're excited to have your contributions!

Thank you , I'll explore other repos also can you tell me how to start? I mean the basics of open source world and everything ( which u can in brief )

@ajaynegi45
Copy link
Owner Author

Hey, I'm a newbie, is this issue still open? I want to learn and contribute and if not is there any other basic good first issue? I am new to open source world but I have always been fascinated by open source .

Hi @Ambit-ion,
Thank you for expressing your interest in working on this issue. However, this issue is currently being worked on by another contributor, @mr-panther01. You can explore other issues in our repository or check out our other projects under the GirlScript Summer of Code and Hacktoberfest.
Here are the links to explore:
https://bento.me/codiescoder
Feel free to reach out if you have any questions or need guidance on where to start. We're excited to have your contributions!

Thank you , I'll explore other repos also can you tell me how to start? I mean the basics of open source world and everything ( which u can in brief )

Checkout this https://youtu.be/o6xikISiz2w?feature=shared

@ajaynegi45 ajaynegi45 reopened this Oct 8, 2024
@ajaynegi45
Copy link
Owner Author

Thank you so much for assigning this issue I assure you that you will get the best output from me

Hi @mr-panther01,

I hope you're doing well! I wanted to check in and see how things are progressing on the Javadoc Comments issue. Have you made any updates or progress on it ? If you’ve encountered any challenges or need assistance, feel free to reach out.

Looking forward to your update!

@mr-panther01 mr-panther01 removed their assignment Oct 12, 2024
@mr-panther01
Copy link

Sorry to tell but I would not be able to contribute on this issue as I am a college student and hasn't been learned this topic

@Ambit-ion
Copy link

@ajaynegi45 Can I try this task ?

@ajaynegi45
Copy link
Owner Author

ajaynegi45 commented Oct 13, 2024

@Ambit-ion Yes you can

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers hacktoberfest hacktoberfest-accepted status: ready for dev You can asked for this issue to be assigned (if not already assigned)
Projects
None yet
Development

No branches or pull requests

3 participants