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

[FEATURE] Add docs for the Website #273

Open
SaptarshiSarkar12 opened this issue Sep 23, 2023 · 62 comments · May be fixed by #378
Open

[FEATURE] Add docs for the Website #273

SaptarshiSarkar12 opened this issue Sep 23, 2023 · 62 comments · May be fixed by #378
Assignees
Labels
documentation 📝 Issues/Pull Requests regarding documentation EddieHub:good-first-issue Label for good-first-issue finder made by EddieHub Community feature ✨ New feature request or addition good first issue Good for newcomers help wanted Extra attention and support are needed Website 🌐 Issues/Pull Requests regarding Website
Milestone

Comments

@SaptarshiSarkar12
Copy link
Owner

SaptarshiSarkar12 commented Sep 23, 2023

Is your feature request related to a problem? Please describe.

The README file currently lacks examples and use cases for both Drifty CLI and GUI. It also does not mention the custom issue labels that the project uses.
Before testing their changes, the contributors need to run some commands. The addition of Dockerfiles to this project via #218 will require some notes and advices, but the README file is already too crowded and lengthy.

Describe the solution you'd like.

I would like to have a docs section for Drifty with sections like - Quickstart, Getting Started, Contributing, FAQ and Troubleshooting.

  • Quickstart: A brief introduction to the main features of Drifty, with a simple example to get users up and running in minutes.
  • Getting Started: A more detailed guide on how to install, configure, and use Drifty, with explanations of the core components and options.
  • Contributing: A section for developers who want to help make Drifty better, with instructions on how to set up a development environment, submit pull requests, and report bugs and new ideas.
  • FAQ: A collection of common questions and answers about Drifty, covering topics such as compatibility, performance, security, and customization.
  • Troubleshooting: This subsection helps to resolve common issues and errors that users may encounter while using Drifty and suggests possible solutions and workarounds.

The docs should be in markdown files and will be rendered by next js. You can read more about this here.

If you have any suggestions to add more suggestions, please let me know.

Screenshots

The docs page can have a look like this -

Image

You can see the live version of the docs homepage here.

Additional information

Skills you need to solve this issue - NextJS, TailwindCSS, MD / MDX in Nextjs.
Those who wish to work on this issue, please leave a comment below and I will assign you with the task.

@SaptarshiSarkar12 SaptarshiSarkar12 added documentation 📝 Issues/Pull Requests regarding documentation EddieHub:good-first-issue Label for good-first-issue finder made by EddieHub Community feature ✨ New feature request or addition good first issue Good for newcomers Website 🌐 Issues/Pull Requests regarding Website labels Sep 23, 2023
@SaptarshiSarkar12 SaptarshiSarkar12 added this to the Drifty v2.1.0 milestone Sep 23, 2023
Repository owner deleted a comment from github-actions bot Sep 23, 2023
@SaptarshiSarkar12 SaptarshiSarkar12 added the help wanted Extra attention and support are needed label Sep 23, 2023
@sathvik-ng-07
Copy link

sathvik-ng-07 commented Sep 24, 2023

Hi SaptarshiSarkar12,

I'm interested in working on this issue. I've reviewed the problem and your proposed solution, and I'd like to contribute to improving the documentation for Drifty as described.

Here's what I plan to do:

  • Create separate Markdown files for each documentation section (Quickstart, Getting Started, Contributing, FAQ, and Troubleshooting).
  • Populate these files with clear and detailed content, including examples and code snippets where necessary.
  • Update the main README file to link to the newly created documentation files.
  • Test the changes locally to ensure they work as expected.
  • Open a pull request (PR) once the changes are ready for review.

Please let me know if you have any specific requirements, guidelines, or additional information I should be aware of before I start working on this. And also let me know if i can submit PR on the master branch itself or some other branch . I'm excited to contribute to the project and help improve its documentation.

Thank you!
Sathvik N G

@SaptarshiSarkar12
Copy link
Owner Author

Thank you @sathvik-ng-07 for your interest in this issue!
Yes, I agree with your plan. Looks good to me. 👍
You need to open the PR to the master branch (the default branch). Please do not open any PR against other branches.
I am assigning you with the task. You can start working on it.

@SaptarshiSarkar12 SaptarshiSarkar12 removed the help wanted Extra attention and support are needed label Sep 24, 2023
@SaptarshiSarkar12 SaptarshiSarkar12 linked a pull request Sep 24, 2023 that will close this issue
3 tasks
@SaptarshiSarkar12
Copy link
Owner Author

@sathvik-ng-07 no longer wants to work on it.

If anyone else wants to work on this issue, please comment below and I will assign you with the task.

@chauhansumitdev
Copy link

I would like to work on this issue.

@SaptarshiSarkar12
Copy link
Owner Author

I would like to work on this issue.

Thank you for your interest in this issue!
I am assigning you with the task.

@SaptarshiSarkar12 SaptarshiSarkar12 added the hacktoberfest Issues/Pull Requests for Hacktoberfest label Sep 26, 2023
@chauhansumitdev chauhansumitdev removed their assignment Oct 2, 2023
@markandey1414
Copy link

Hello @SaptarshiSarkar12 , I would like to work on this issue and resolve it.

@SaptarshiSarkar12
Copy link
Owner Author

@markandey1414 Yes, you can work on this issue. Assigning the task to you.

You can discuss this issue in our Discord server.

@Neel-07
Copy link

Neel-07 commented Oct 3, 2023

hello @SaptarshiSarkar12, can you assign this issue to me i would like to work on this issue.

@SaptarshiSarkar12
Copy link
Owner Author

If @markandey1414 no longer wants to work on this issue, then, I can assign you (@Neel-07 ). Let's wait for his (@markandey1414 ) reply.

@markandey1414
Copy link

Yes @SaptarshiSarkar12 I'm working on it. Thanks for assigning me this.

@SaptarshiSarkar12
Copy link
Owner Author

Okay @markandey1414.

@markandey1414
Copy link

@SaptarshiSarkar12 permission to access the repo is denied, not able to issue pr

@SaptarshiSarkar12
Copy link
Owner Author

@markandey1414 Why? Can you please show the exact error?

@SaptarshiSarkar12
Copy link
Owner Author

@hasnainmakada-99 It's okay. No problem. Have some rest 😄, take care.

@goody-dev
Copy link

@goody-dev Welcome to the Open-Source community 😄! Thank you for your interest in this issue 🙏.
Sorry, currently this issue is being worked on by @hasnainmakada-99 via Pull Request #378. If he needs any help or you want to modify any of his changes, then, you are welcome to do so.

Alright, no problem.

@SaptarshiSarkar12
Copy link
Owner Author

@goody-dev Thank you for your cooperation! 😊

@SaptarshiSarkar12 SaptarshiSarkar12 removed the help wanted Extra attention and support are needed label Dec 29, 2023
@SaptarshiSarkar12
Copy link
Owner Author

@goody-dev The one (@hasnainmakada-99) who has the issue assigned will not be able to create the feature to render the markdown files of docs. So, can you do that?

@SaptarshiSarkar12 SaptarshiSarkar12 added the help wanted Extra attention and support are needed label Jan 1, 2024
@goody-dev
Copy link

Yes, I would be glad to @SaptarshiSarkar12

@SaptarshiSarkar12
Copy link
Owner Author

Great 😃! Then, @hasnainmakada-99 will create the markdown files which contains the contents of docs pages. And you (@goody-dev) can create the feature that renders those docs pages contents. Is that okay for both of you?

@SaptarshiSarkar12 SaptarshiSarkar12 removed the help wanted Extra attention and support are needed label Jan 2, 2024
@goody-dev
Copy link

Yes, @SaptarshiSarkar12. That's fine.

@SaptarshiSarkar12
Copy link
Owner Author

Okay. Thank you @goody-dev 👍.

@goody-dev
Copy link

goody-dev commented Jan 4, 2024

Pls inform me when I can start working on it, @SaptarshiSarkar12. It seems like work is still ongoing on the MD files.

@SaptarshiSarkar12
Copy link
Owner Author

@goody-dev You can start working on tha feature. For now, you can create test MD files which will get rendered. Later on, when @hasnainmakada-99's PR gets merged, I'll update your MD files with his.
Is that okay for you 🙂?

@goody-dev
Copy link

@goody-dev You can start working on tha feature. For now, you can create test MD files which will get rendered. Later on, when @hasnainmakada-99's PR gets merged, I'll update your MD files with his.
Is that okay for you 🙂?

That's alright.

@goody-dev
Copy link

@SaptarshiSarkar12, I have been unable to clone the repository to my local machine due to weak internet connection. I would get back to you if I have been able to clone it, and if anyone comes around before then and would to take on it they are free to.

@SaptarshiSarkar12
Copy link
Owner Author

Okay. It's fine. You can take your time 😄 @goody-dev.

@SaptarshiSarkar12
Copy link
Owner Author

@goody-dev Were you able to clone the repo?

@goody-dev
Copy link

No, I haven't been able to... And I have cloned another repo in between trying to.

@SaptarshiSarkar12
Copy link
Owner Author

Okay. If you are able to clone it later on, please inform me.

@SaptarshiSarkar12
Copy link
Owner Author

No, I haven't been able to... And I have cloned another repo in between trying to.

@goody-dev Were you able to clone the repo successfully 😄?

@hasnainmakada-99 hasnainmakada-99 removed their assignment Apr 18, 2024
@goody-dev
Copy link

goody-dev commented May 3, 2024 via email

@SaptarshiSarkar12
Copy link
Owner Author

@goody-dev Okay. Thank you 👍🏻.

@SaptarshiSarkar12 SaptarshiSarkar12 added the help wanted Extra attention and support are needed label May 4, 2024
@SaptarshiSarkar12 SaptarshiSarkar12 pinned this issue May 13, 2024
@abhilashreddysh
Copy link

@SaptarshiSarkar12 I can work on this. You can assign this issue to me.

@SaptarshiSarkar12
Copy link
Owner Author

@abhilashreddysh Thank you for your interest on this issue, Abhilash 😄!
I am assigning the issue to you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation 📝 Issues/Pull Requests regarding documentation EddieHub:good-first-issue Label for good-first-issue finder made by EddieHub Community feature ✨ New feature request or addition good first issue Good for newcomers help wanted Extra attention and support are needed Website 🌐 Issues/Pull Requests regarding Website
Projects
Status: Todo
8 participants