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

Documentation: Documenting Codes in the Scripts Folder #57

Closed
CristopherAguilar10 opened this issue Nov 20, 2024 · 9 comments · Fixed by #60
Closed

Documentation: Documenting Codes in the Scripts Folder #57

CristopherAguilar10 opened this issue Nov 20, 2024 · 9 comments · Fixed by #60
Assignees
Labels
documentation Improvements or additions to documentation external-contributors good first issue Good for newcomers ODHack10

Comments

@CristopherAguilar10
Copy link
Contributor

The code in the Scripts folder needs documentation to improve its understanding and facilitate collaboration with other developers.

image

Tasks:

  1. Add XML comments to methods, classes and public variables.
  • Example:
/// <summary> 
/// Controls the movement of the player.
/// </summary> 
/// <param name=“speed”>Speed of the movement.</param> 
void MovePlayer(float speed) { // Implementation here }
  1. Document the general functionality of each script:
  • What the script does.
  • Where and how it is used.
@CristopherAguilar10 CristopherAguilar10 added documentation Improvements or additions to documentation good first issue Good for newcomers external-contributors labels Nov 20, 2024
@martinvibes
Copy link

May I try my hand at this? I have done some merged docs for other repos
It would be my first time on this repo
Kindly assign :)

@pheobeayo
Copy link

May I handle this issue?

I am a web3 frontend developer and Technical writer. I have successfully contributed to projects on the OnlyDust platform, writing Cairo, and Rust codes, cleaning up the codebase and properly documentating the codes.

I will tackle this issue by going through the documentation properly, studying the script codes, understanding the codes, understanding the functions and writing out the functions in the proper documentation for better understanding of developers and users.

@raizo07
Copy link

raizo07 commented Nov 21, 2024

I’d like to resolve this.

@josephpdf
Copy link
Contributor

Hi! @CristopherAguilar10
I'm Joseph Poveda, I'm a member of the Dojo Coding community.
A bit about my background is that I'm just starting out with Only Dust and I want to contribute as much as I can to the project. My knowledge of different programming languages ​​will allow me to better solve problems.
Now to tackle the problem of documenting scripts folder:

  1. Review the Scripts — Go through each of the scripts in the folder to understand how they function, their purpose, and implementation.
  2. XML Comments: Add XML comments to methods, classes and public variables. For example:
/// <summary>
/// Controls player movement.
/// </summary>
/// <param name="speed">The speed of movement.</param>
void MovePlayer(float speed) { }
  1. Document Script Descriptions : You are writing what exactly each script do and in which it is used, so developer will understand easily.
  2. Put Content in Structure: Properly document everything so it can be accessed and understood with ease.

@BraCR10
Copy link
Contributor

BraCR10 commented Nov 21, 2024

Hello maintainers I am BRACR10 a contributor from Dojo Coding, I would like to take the documentation of those scripts, I have experience with object oriented programming and C#. Before requesting the issue I looked the scripts and the without problems could comment them properly with XML format.

@CristopherAguilar10
Copy link
Contributor Author

Hi @josephpdf, I assign you, if you have any questions I will be glad to help you.

@0xdevcollins
Copy link

Could I be assigned to this?

My Background
I am a Full Stack Blockchain Developer with proficiency in Solidity/Rust, Next.js, TypeScript, React, and Node.js. I've demonstrated my ability to adjust to a variety of requirements, perform well under pressure, and reliably produce user-centric blockchain solutions with 46 significant contributions spread over 12 OnlyDust projects.

@emmz3230
Copy link

I am a front-end developer specializing in responsive web design,
device-compatible email templates, 3D web integration,
and technical writing on programming topics.

step on how to solve this issue
I will take my time to understand the script code and document it in the code or create a script.md file to better understand the code by any developer using my project documenting skill to stat what it does and how it is used, which I can say is one of my habits when seeing large codebases.

will be glad to work on this
Thanks

@NueloSE
Copy link

NueloSE commented Nov 21, 2024

Am a technical writer with experience in documenting code base

previous work done that is exactly same as the bytebeast doc script

Can I contribute to this one?
ETA <= 2days

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 external-contributors good first issue Good for newcomers ODHack10
Projects
None yet
Development

Successfully merging a pull request may close this issue.

10 participants