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

Update and Enhance CofiBlocks README Documentation #63

Closed
evgongora opened this issue Nov 21, 2024 · 22 comments · Fixed by #73
Closed

Update and Enhance CofiBlocks README Documentation #63

evgongora opened this issue Nov 21, 2024 · 22 comments · Fixed by #73
Assignees
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers ODHack10

Comments

@evgongora
Copy link
Collaborator

Description:

The current README for CofiBlocks contains detailed information but needs refinement to improve readability, usability, and consistency. The objective is to centralize and structure the documentation, ensuring it effectively communicates the project’s purpose, technical setup, and contribution guidelines.

  1. Streamline Project Introduction
  • Clearly outline what CofiBlocks is, its mission, and how it operates.
  • Ensure concise descriptions of key concepts like Collaborative Business, NFTs, and COFI tokens.
  1. Improve Setup Instructions
  • Provide clear and error-free steps for project setup and development environment configuration.
  1. Centralize Development Resources
  • Include detailed instructions for using tools like CofiBlocks Dev Assistant.
  • Add information on key technologies like Starknet, Prisma, and Bun.
  1. Remove Contribution Guide
  • We will create a different file for this.
  1. Highlight Roadmap and Team
  • Clearly present the project’s roadmap with upcoming milestones.
  • Introduce team members with concise bios.
@evgongora evgongora added good first issue Good for newcomers ODHack10 documentation Improvements or additions to documentation labels Nov 21, 2024
@mimisavage
Copy link

@evgongora

I'm eager to take on this challenge and deliver quality work. May I proceed with it?

@ShantelPeters
Copy link

ShantelPeters commented Nov 21, 2024

Hi @evgongora
please can i be assigned to this issue

To resolve this issue, I will streamline the CofiBlocks README by clearly explaining its mission, operations, and key concepts like Collaborative Business, NFTs, and COFI tokens.
Next I will improve setup instructions and centralize development resources, including tools like CofiBlocks Dev Assistant and technologies like Starknet, Prisma, and Bun. Then the contribution guide will be moved to a separate file. Additionally, I will highlight the project’s roadmap and team with concise bios and upcoming milestones.

@0xdevcollins
Copy link

Can I handle this task?

@Kingsuite
Copy link

Can I take care of this issue?

@abdegenius
Copy link

Is this issue still available? Would love to tackle this! I can comfortably handle this issues

@pheobeayo
Copy link

Could I grab this task?
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 Pull Request (PR) 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 benefit users and developers.
  • Write a well-structured template containing the needed information using the correct references.
  • Note changes and define all code snippets and technical terms simply.
  • Create a Pull Request (PR)
  • Request for a Review
  • Make changes based on the Review of the PR

@Iwueseiter
Copy link

Can I attempt this issue?
I'm a frontend/smart contract developer and a technical writer.
Here are links to comprehensive docs I've written and have been merged Flex-NFT-Marketplace/Flex-Marketplace-Contract#107, cairo-book/cairo-book#1019, horuslabsio/tokenbound-contract-docs#12, sivicstudio/starkludo#102, https://hackmd.io/@-__sK8xkRjuXHkFZQLyYXg/HkLcMImM1l.

@martinvibes
Copy link

Can I take care of this issue?
i'm a frontend dev and a blockchain dev please kindly assign :)

@mexes20
Copy link

mexes20 commented Nov 21, 2024

ew developers, community members, and contributors quickly find answers to their questions

@josephpdf
Copy link

Hi! @evgongora
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.
To solve this issue I will:

  1. Optimize the Project Introduction:
  • Clearly describe what CofiBlocks is, its mission, and how it operates.
  • Ensure concise descriptions of key concepts like Collaborative Business, NFTs, and COFI tokens.
  1. Improve Setup Instructions:
  • Provide clear and error-free steps for project setup and development environment configuration.
  1. Centralize Development Resources:
  • Include detailed instructions for using tools like CofiBlocks Dev Assistant.
  • Add information on key technologies like Starknet, Prisma, and Bun.
  1. Remove the Contribution Guide:
  • Create a separate file for contribution guidelines.
  1. Highlight the Roadmap and Team:
  • Clearly present the project’s roadmap with upcoming milestones.
  • Introduce team members with concise bios.
    I hope this helps you structure your README effectively.

@Iwueseiter
Copy link

Is it okay if I take this?
I'm a frontend/smart contract developer and a technical writer.
Here are links to comprehensive docs I've written and have been merged Flex-NFT-Marketplace/Flex-Marketplace-Contract#107, cairo-book/cairo-book#1019, horuslabsio/tokenbound-contract-docs#12, sivicstudio/starkludo#102, https://hackmd.io/@-__sK8xkRjuXHkFZQLyYXg/HkLcMImM1l.

@gchimelu
Copy link

Having gone through the CofiBlocks website and understood your mission of improving the coffee industry in Costa Rica, I would love to help you enhance your documentation, to make it more detailed and readable. I have worked with a lot of Web3 brands as a technical and content writer, so you will be getting the best of both worlds with me.

@Benjtalkshow
Copy link

Could I take on this issue?

@ShantelPeters
Copy link

Can I try solving this issue?

@Michaelkingsdev
Copy link

May I take this issue on?

@od-hunter
Copy link
Contributor

Hello can I be assigned this please? I am a blockchain developer and I'm also good at documentations. I'll refine the README to improve readability, usability, and consistency to better communicate the project’s purpose, technical setup, and contribution guidelines.

Below are some of the documentations I've done that were merged:
dojoengine/book#308,
keep-starknet-strange/joyboy#143,
Scaffold-Stark/ss2-docs#31,
horuslabsio/Starknet-Scaffold#94,
Hyle-org/examples#15.

Please I’m ready to work, assign me please.

@akintewe
Copy link

Hi, I'm akintewe and i would love to work on this issue
I My ETA is > 24hrs to complete.

I am very good with documentation too.

I am a new contributor, happy to help :)

@ryzen-xp
Copy link

Can I work on this, please?

@vestor-dev
Copy link

hey sir I'd like to handle this task.
i'm a frontend developer with experience
i would really love to contribute to your project
kindly assign :)

@aguilar1x
Copy link
Contributor

aguilar1x commented Nov 21, 2024

Good morning, My name is Matias Aguilar, I am a software development engineer with 1 year of experience in backend and some Frontend. 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.

Implementation and solution to the problem

I'm going to cover certain important points for the implementation of the docu, without leaving aside how I would start working on it

1. Fork Repository and create code in the same

  • The Fork of the main repository of the project to my normal repository will be created.
  • The corresponding code will be created for the README.md, if necessary I will send you a message to know how you would like in terms of format
  • The steps of everything will begin to be implemented.

2. Create Introduction

In this part there will be an introduction / explanation of guide lines to follow for the redame.md

README.md

The corresponding README.md will be created in a repository with:

  1. Project information
  2. Project structure
  3. Video presentation or page
  4. Team Members
  5. Technologies used
  6. And installation of the repository on its main fork
  • I saw that you already have a guideline on how to do it so I would base myself largely on that.

Doubts and recommendations

I'm waiting for questions and recommendations on how you would like to carry out the implementation of the README.md, so if you need any change or implementation of something or another. And maybe add the social media in the introduction of cofiblocks

ETA

1 day

@Kritto
Copy link

Kritto commented Nov 22, 2024

Could I be assigned to this?

@Kaminar-i
Copy link

Mind if I take this issue?
i'm new and would love to work on this

@aguilar1x aguilar1x mentioned this issue Nov 27, 2024
12 tasks
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 ODHack10
Projects
None yet
Development

Successfully merging a pull request may close this issue.