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

More and better examples #260

Open
igaray opened this issue Aug 1, 2023 · 11 comments
Open

More and better examples #260

igaray opened this issue Aug 1, 2023 · 11 comments
Labels
difficulty-easy documentation Improvements or additions to documentation good first issue Good for newcomers help wanted Extra attention is needed

Comments

@igaray
Copy link
Collaborator

igaray commented Aug 1, 2023

The README should include more runnable commands and code snippets on how to use cairo_native, to help onboarding and users understand what is capable with the library.

@igaray igaray added the documentation Improvements or additions to documentation label Aug 1, 2023
@igaray igaray added this to the ERC20 milestone Aug 1, 2023
@igaray igaray added this to Starknet Aug 1, 2023
@igaray igaray moved this to Todo in Starknet Aug 4, 2023
@igaray igaray modified the milestones: ERC20, Production Ready, Merry Xmas Dec 12, 2023
@igaray igaray moved this from Todo to Backlog in Starknet Jan 15, 2024
@igaray igaray moved this from Backlog to Todo in Starknet Feb 20, 2024
@igaray igaray added good first issue Good for newcomers help wanted Extra attention is needed odhack labels Mar 13, 2024
@estheroche
Copy link

I can take this, can you kindly assign to me?
thank you

@igaray
Copy link
Collaborator Author

igaray commented Mar 14, 2024

Done! feel free to ask questions here or in telegram at https://t.me/LambdaStarkNet

@estheroche
Copy link

thank you

@NueloSE
Copy link

NueloSE commented May 23, 2024

@igaray can I work on this

@RJMadrigal
Copy link

@igaray i would like to take this :)

@PhantomOz
Copy link

@igaray can I work on this?

@nemealfaro
Copy link

Hi @igaray my name is Némesis Alfaro, I'm a System Engineer focused on frontend, database and IT business administrator
I would like to take this task because I would like to research the topic and gain more knowledge, to provide you with more examples and details to improve your understanding of this topic.

@od-hunter
Copy link

od-hunter commented Jun 21, 2024

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

Great! Can I be assigned this please. I’m a full stack developer and a documentarian. Below are some of the documentations I've done that were merged:

keep-starknet-strange/joyboy#143 (comment),

horuslabsio/Starknet-Scaffold#94 (comment).
Some of my documentations outside GitHub:

https://t.co/ZgK0ccPZpw,

https://t.co/GnBqVQPECz.

How I plan on tackling this issue

In other to come up with a better README for this repo I’ll:

  1. Add Installation Instructions: Include detailed steps for cloning the repository and installing dependencies.
  2. Provide Basic Usage Examples: Show how to compile and run a simple Cairo program with specific commands.
  3. Include Test Commands: Explain how to run tests to verify the installation.
  4. Offer Code Snippets: Present sample Cairo code snippets with corresponding runnable commands.
  5. Link to Advanced Examples: Direct users to more complex examples within the repository for deeper learning.

By following these steps, the README will be more user-friendly and help onboard new users more effectively.
Here is my OnlyDust profile: https://app.onlydust.com/u/od-hunter.
I will raise a PR within #-5 days unfailingly. Please assign me thank you.

@Ternder001
Copy link

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

My recent work with Ethereum-Solidity and Starknet-Cairo has significantly deepened my understanding of web3 technologies, positioning me well to contribute to innovative projects in the blockchain space. As an alumnus of Web3Bridge, where I received training in Solidity and Cairo, I have developed a solid foundation in these technologies. I am eager to contribute to open-source projects within the Starknet ecosystem, and I am particularly excited about the opportunity to make meaningful contributions to this project. Given the chance, I am committed to delivering my best work and leveraging my skills to drive success.

How I plan on tackling this issue

I will approach this problem by creating a comprehensive README for Cairo Native that includes runnable commands and code snippets, follow these steps:

  1. Introduction
    Provide a brief introduction to Cairo Native, highlighting its purpose and key features.
  2. Installation
    Include clear instructions on how to install Cairo Native.
  3. Basic Usage
    Demonstrate basic usage with simple examples.
  4. Advanced Features
    Showcase advanced features with more complex examples.
  5. Integration Examples
    Provide examples of how to integrate Cairo Native with other tools and sequencer implementations.
  6. Contribution Guidelines
    Outline how users can contribute to the project.
  7. Support and Resources
    List available support channels and additional resources.

@igaray igaray removed the odhack label Aug 28, 2024
@gconnect
Copy link

I am applying to this issue via OnlyDust platform.

My background and how it can be leveraged

I am a software developer with over 5 Yeats of experience building both web and mobile applications and dapps and writing technical documentations with special interest in tutorial documentation. My tutorial content helps make the user/developer onboarding process into a tech or platform much easier. User onboarding and experience is something dear to my heart so I try to build applications and write content that makes the process easier.

How I plan on tackling this issue

My Approach would be to first of all study the current state of the documentation. Understand how the cairo_native library works and build a real world application to show the use case of the library. Ensure the sample application works as expected and then write a tutorial on how it was built using the library.

With this users can clearly see what is possible with the library and make the process of using the application much easier.

@mymiracle0118
Copy link

Can I start working on this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
difficulty-easy documentation Improvements or additions to documentation good first issue Good for newcomers help wanted Extra attention is needed
Projects
Status: Backlog
Development

No branches or pull requests

10 participants