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

[CT]: Create a README.md for Contracts in StarShop #1

Open
aguilar1x opened this issue Dec 15, 2024 · 29 comments
Open

[CT]: Create a README.md for Contracts in StarShop #1

aguilar1x opened this issue Dec 15, 2024 · 29 comments
Assignees
Labels
Contracts documentation Improvements or additions to documentation easy good first issue Good for newcomers ODHACK11

Comments

@aguilar1x
Copy link
Contributor

📝 Description

A complete and beginner-friendly guide is required to set up the environment for deploying Smart Contracts using Stellar. The guide should provide step-by-step instructions and simplify the setup process.

The README.md document should be located in the root directory of the repository and will serve as a starting point for new developers.


Acceptance Criteria

1. README.md Structure

  • Markdown file with a clear and organized table of contents.

2. Content Coverage

The guide must include the following:

  1. Prerequisites: Necessary tools and dependencies.

  2. Environment Setup:

    • Configuring Stellar Smart Contracts.
    • Specific steps to install related tools or plugins.
  3. Wallet Configuration:

    • Instructions to connect and configure the wallet.
  4. Compilation and Deployment:

    • Detailed explanation for compiling and deploying Smart Contracts.
  5. Testing and Execution:

    • A practical, verified example of a deployed Smart Contract.
  6. Troubleshooting:

    • Tips and solutions for common errors during the setup process.

3. Practical Example

  • Provide a basic example of configuring and deploying a Smart Contract from the repository.

4. Clarity

  • Use beginner-friendly language and clear explanations.
  • Include relevant commands to guide the process.
  • Add suggestions for solving common problems.

🔗 References


📌 Additional Notes

  • Validate each step before updating the repository.
  • Ensure the Markdown file has a clean and consistent format.
@aguilar1x aguilar1x added documentation Improvements or additions to documentation good first issue Good for newcomers ODHACK11 easy Contracts labels Dec 15, 2024
@aguilar1x aguilar1x changed the title [CT]: Add RADME.md for Contracts in StarShop [CT]: Create a RADME.md for Contracts in StarShop Dec 15, 2024
@Jagadeeshftw
Copy link

Hi @aguilar1x , I would like to work on this

@aguilar1x aguilar1x changed the title [CT]: Create a RADME.md for Contracts in StarShop [CT]: Create a README.md for Contracts in StarShop Dec 15, 2024
@1nonlypiece
Copy link

Hi @aguilar1x ,
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!

@emarc99
Copy link

emarc99 commented Dec 15, 2024

I'd like to handle this task.
I will follow the steps given to create a beginner friendly docs for your awesome project. ETA 1 day..

@jahrulezfrancis
Copy link

I would love to take on this task of creating a beginner-friendly guide for deploying Stellar Smart Contracts.
I intend to craft a clear and well-structured README.md with step-by-step instructions, covering everything from prerequisites to deployment and troubleshooting.
I’ll ensure the guide is practical, easy to follow, and includes a working example for seamless onboarding.
I'm positive on delivering a polished and comprehensive guide that aligns with your acceptance criteria within 8 to 12 hours.

@Ibinola
Copy link

Ibinola commented Dec 15, 2024

Can I take this issue?

I have worked on documentation on these open source projects here and SafeTrust

@ooochoche
Copy link

ooochoche commented Dec 15, 2024

Gm, I have read the description for the documentation and I can meet the acceptance criteria.

@salazarsebas
Copy link

Hi StarShop,

My background

I'm Sebastian, software engineer 👨🏻‍💻 and part of the Dojo Coding ⛩️ community, and I would like to contribute to this issue. I have experience with different technologies and I have worked on some projects through OnlyDust and I like to contribute to help the projects.

How I plan on tackling this issue

To solve this issue, I will perform the following steps:

  • Read the Stellar documentation thoroughly to add prerequisites and reference links.
  • Do a thorough research on the development environment, configuration of wallets with smart contracts, compilation, testing and common bugs.
  • Write possible solutions for the above mentioned.
  • Make a very user friendly and easy to understand writing.
  • Maintain constant communication with the mainteiners to clarify doubts.
  • Perform all the tests and send the pr waiting for feedback.

@3th-Enjay
Copy link

I’d like to resolve this.

@GideonBature
Copy link

Can I handle this task?

@Benjtalkshow
Copy link

Is it okay if I tackle this?

@Michaelkingsdev
Copy link

Can I be assigned to this?

@ryzen-xp
Copy link

Can I handle this task?
Hi, I am proficient Blockchain developer expert in Cairo , Rust and Solidity and also in Full stack web development.
please /assign this issue .
Thank You

@akintewe
Copy link

Hi @aguilar1x , I am Akintewe and 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 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

@Amarjeet325
Copy link

Could I take over this issue?

@BrunoAmbricca
Copy link

I would like to work on this issue

@Rayguti
Copy link

Rayguti commented Dec 15, 2024

Approach:
Define Requirements: Identifies the tools needed to deploy Smart Contracts on Stellar, including dependencies, environment configurations, and a working example.

Set Up the Environment: Provides detailed steps for installing related tools, setting up the Stellar testnet, and preparing a wallet for development.

Connect and Configure the Wallet: Ensures that the wallet is properly connected to the Stellar network and has test funds to perform the necessary operations.

Build and Deploy Contracts: Develops a section explaining how to build and deploy Smart Contracts, ensuring clarity in the commands and configurations used.

Test and Run: Includes a practical example for testing a deployed Smart Contract, detailing the steps and showing expected results.

Troubleshoot: Provides a section with possible common errors during the process, along with clear solutions and debugging recommendations.

Validate the Process: Ensure that all steps have been tested in a controlled environment, ensuring that the process is reproducible by novice developers.

@davedumto
Copy link

Hi,
My name is David, and I have experience in technical writing and creating beginner-friendly guides. I’m excited to create a clear and validated README.md for setting up Stellar Smart Contracts, covering prerequisites, setup, deployment, and troubleshooting.
I’ll ensure it’s beginner-friendly and complete within the timeline. ETA 2days

@tosinmoses384
Copy link

Is it okay if I take this?

I am a senior software engineer and I should be able to complete this task in a couples of minutes or few hours.

The following will take into account:

  1. Create a README.md structure

  2. Consider all the content coverage e.g list necessary tools and dependencies, setup etc

  3. Review the entire document over and over again

Thank you

@jaykayudo
Copy link

Can i be assigned this?

@Awointa
Copy link

Awointa commented Dec 15, 2024

Can I try solving this issue?

@Birdmannn
Copy link

Please I'd love tp tackle this issue. I am also a new contributor to OD

@olisaagbafor
Copy link

Could I be assigned to this?

@Supa-mega
Copy link

Can I contribute to this one? first time contributor

@0xdevcollins
Copy link

Can I be assigned this issue? This will be my first time contributing to this project

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 58 significant contributions spread over 17 OnlyDust projects.

@Agbeleshe
Copy link

Can I attempt this issue?

@aguilar1x
Copy link
Contributor Author

Hello @mimiprosper

The issue has just been assigned to you, if you have any questions, don't hesitate to ask! 🚀

@mimiprosper
Copy link
Contributor

Thanks for assigning this task to me. Am working on the task now!!!

@mimiprosper
Copy link
Contributor

@aguilar1x
I have made a pull request for: [CT]: Create a README.md for Contracts in StarShop

I wait for your response.
Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Contracts documentation Improvements or additions to documentation easy good first issue Good for newcomers ODHACK11
Projects
None yet
Development

No branches or pull requests