Skip to content
New issue

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

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

Already on GitHub? # to your account

Add documentation for one script #64

Closed
danielcdz opened this issue Dec 11, 2024 · 22 comments · Fixed by #75
Closed

Add documentation for one script #64

danielcdz opened this issue Dec 11, 2024 · 22 comments · Fixed by #75
Assignees
Labels
difficult: easy documentation Improvements or additions to documentation

Comments

@danielcdz
Copy link
Member

danielcdz commented Dec 11, 2024

Add documentation for one script

Objective

Create a documentation (readme), as a general structure/template to use for the scripts

Flow

  • Choose one script of your interest
  • Create a structure/readme for this contract explaining the script's parts, objetive, use cases or other important sections that you can provide.

📜 Additional Notes

Do not apply until the ODHack begins.
Read our guidelines before applying.

@danielcdz danielcdz added documentation Improvements or additions to documentation difficult: easy ODHack11 labels Dec 11, 2024
@aurlic
Copy link
Contributor

aurlic commented Dec 12, 2024

Hey I would like to try myself at this, and find a script I could document.

@Thibrac
Copy link
Contributor

Thibrac commented Dec 12, 2024

I'd like to take this issue. I've already made a script, I'm willing to write its doc ;)

@greatest0falltime
Copy link

Hi,

I’d be thrilled to work on this issue as I have a strong background in crafting well-structured and accessible documentation.

Proposed Approach:

ETA:
I expect to have a working solution ready within the next 24 hours. Kindly let me know if I can proceed!

Looking forward to contributing!

@BrunoAmbricca
Copy link
Contributor

I would like to work on this issue

@1nonlypiece
Copy link

Hi ,
I’d like to work on this issue as I have experience in creating and maintaining clear and user-friendly documentation..

ETA:
I estimate completing this task in about 12-24 hours. Let me know if I can get started!

@mimiprosper
Copy link
Contributor

I would like to take this task. Am a web 2 frontend developer, a technical writer, a solidity smart contract developer/auditor and a cairo smart contract developer. Am a graduate of Starknet Cairo Bootcamp. I have successfully done tasks assigned to me in OnlyDust.
If assigned this i would complete it within 2 days. Here are some articles i have written: https://medium.com/@emma.onyedika.okeke

@GideonBature
Copy link
Contributor

I'd love to work on this!

@josephchimebuka
Copy link

Could I be assigned to this?

@Michaelkingsdev
Copy link
Contributor

Would love to tackle this!

@Akshola00
Copy link

Can I try solving this issue?

@ryzen-xp
Copy link
Contributor

Hi, I am a proficient blockchain developer, expert in Cairo, Rust, Solidity, Aptos, and web development. I have contributed to projects like Chainevents and Arkprojects ,sunshine etc.
I can create clear and structured documentation for a script, outlining its parts, objectives, use cases, and other important sections, providing a template for other scripts. Please assign this issue to me.

Thank you!

@zanastas
Copy link

Excited to contribute to this task! I’ve written several GitHub documentations for EthGlobal hackathons and recently published a blog post on “Getting Started with Semaphore,” which provides step-by-step instructions for setting up a new project and references to resources. Feel free to check it out here

@pheobeayo
Copy link
Contributor

Let me try this one!

I am a Web3 front-end developer skilled in technical documentation and software development. I greatly understand technologies like JavaScript, Typescript, Cairo, Rust and Solidity. I have contributed successfully to open-source projects like Stark Quest and Speedrun scaffold-stark
My Approach includes:

  • Reviewing of existing Documentation:
    by thoroughly reading the current documentation, including README files, code comments, and any other relevant documentation provided in the repository.
    Identify areas that are unclear, outdated, or missing crucial information that would be of benefit to users and developers
  • Make note of changes and define all code snippets and technical terms in simple terms.
  • Create a Pull Request (PR).
  • Request for a Review.
  • Make changes based on the review of the PR.

@aguilar1x
Copy link
Contributor

aguilar1x commented Dec 12, 2024

Hello, My name is Matias Aguilar, I'm a software development engineer with 1 year of experience in backend, some Frontend and I'm currently constantly studying Smart Contract with Rust in Stellar and Cairo in Starknet. I have worked on several issues on documentation so I already have an idea of how to implement everything and make it understandable and clean at the same time. I am a member of Dojo Coding, and I would really love to participate in the project with this issue.

Resolution

  1. Choose a Script:

    • Select one script from the repository that you are interested in documenting.
  2. Create a README Structure:

    • Provide a general introduction to the script, including its purpose.
    • Explain the different parts of the script and their functions.
    • Add objective details and potential use cases for the script.
    • Include any additional important information, such as limitations, prerequisites, or dependencies.
  3. Ensure Completeness:

    • Test the script and validate that the documentation aligns with its functionality.
    • Use a clear and beginner-friendly format.

@tasneemtoolba
Copy link

can I work on this task?

@ShantelPeters
Copy link
Contributor

Could I take on this issue?

@Supa-mega
Copy link

I’m interested in this one.

@omsant02
Copy link
Contributor

I would like to take this issue

I can pick a script from the cairo/scripts directory (like fibonacci or simple_math) and create a detailed README that explains the script's purpose, implementation details, and usage examples.

ETA : 5hrs

@emmz3230
Copy link

Let me try this one!

I am a front-end developer specializing in responsive web design,
device-compatible email templates, 3D web integration,
and technical writing on programming topics. I also contribute
to open-source documentation and help build documentation sites.

@vestor-dev
Copy link

hey sir i would love to work on this issue
i'm a blockchain dev and i would love to handle this issue
assign me and i'll get to work

@Jagadeeshftw
Copy link
Contributor

Hello, I’d love to work on this issue as I have strong experience in developing secure and efficient smart contracts using Cairo and deploying them on StarkNet. Please assign this to me, and I’ll ensure to deliver a robust and high-quality PR within 12-24 hours.

@mimiprosper
Copy link
Contributor

Thanks for assigning this task to me. Am working on it right now.

@mimiprosper
Copy link
Contributor

Am working on the Docs update, i would be done immediately

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
difficult: easy documentation Improvements or additions to documentation
Projects
None yet