AgentGPT icon indicating copy to clipboard operation
AgentGPT copied to clipboard

✨ Create a guide on how to update the documentation website

Open asim-shrestha opened this issue 1 year ago • 24 comments

We should update the docs site (https://docs.reworkd.ai/development) with some documentation for how to update the docs site itself. It should cover the following:

  • Intro on what mintlify is and link to it
  • Talk about how to run the site locally
  • Talk about how to update a page or create a new page
  • Talk about exactly what we want documented
  • Talk about how to request for documentation (Make an issue on GitHub!)

asim-shrestha avatar Jun 27 '23 02:06 asim-shrestha

@asim-shrestha maybe we could update the Docs README since we already have a guide on how to run the docs site locally. Alternatively, we could update the Docs Contributing file. Which option do you think would be better?

MusabShakeel576 avatar Jun 28 '23 10:06 MusabShakeel576

@asim-shrestha Hi, I would want to work on this issue.

momokid avatar Jul 14 '23 18:07 momokid

@momokid please go for it!

asim-shrestha avatar Jul 15 '23 02:07 asim-shrestha

Sorry I missed this @MusabShakeel576! I think a page on the docs site itself makes sense

asim-shrestha avatar Jul 15 '23 02:07 asim-shrestha

@asim-shrestha no worries. Yeah that would be good.

MusabShakeel576 avatar Jul 15 '23 09:07 MusabShakeel576

Hello @momokid Have you had any luck on this issue?? I can help you get started if not !!

jasangill1 avatar Jul 19 '23 01:07 jasangill1

Hi @jasangill1 , I will be glad with all the help I can get. I was checking out muntlify, but I had some challenges. Sorry for not reverting sooner

momokid avatar Jul 19 '23 04:07 momokid

Hello @momokid what issues were u facing ??

jasangill1 avatar Jul 19 '23 19:07 jasangill1

I wanted to run the mintlify setup locally and try out how it works, but I got an error during the installation. I was advised to install the previous mintlify version, but again, I got an error.

momokid avatar Jul 19 '23 20:07 momokid

are you using a new mintlify file? or are you running the AgentGPT docs?? What command are you running to start the mintlify server?

jasangill1 avatar Jul 19 '23 21:07 jasangill1

I am using the new mintlify file and I used the mintlify dev to start the mintlify server

momokid avatar Jul 20 '23 04:07 momokid

@jasangill1 This is the snapshot of the error mintlifydev

momokid avatar Jul 20 '23 04:07 momokid

@jasangill1 would you suggest I continue working on this issue without necessarily waiting for this bug to be fixed?

momokid avatar Jul 20 '23 04:07 momokid

Hello @momokid could you try to run the command: yarn i -g mintlify

jasangill1 avatar Jul 22 '23 04:07 jasangill1

@jasangill1 sure.

momokid avatar Jul 22 '23 04:07 momokid

Hello @momokid did anything change once that happened? If not I'm happy to help you get this going maybe over a discord call or some more screenshots !! https://discord.gg/tKE5JeGD

jasangill1 avatar Jul 22 '23 18:07 jasangill1

Hello @momokid did anything change once that happened? If not I'm happy to help you get this going maybe over a discord call or some more screenshots !! https://discord.gg/tKE5JeGD

image I got this error when I run yarn i -g mintlfy but npm i -g mintlify runs just fine.

momokid avatar Jul 23 '23 04:07 momokid

@jasangill1 Thank you so much for the support. I have finally set up the mintlify locally.

momokid avatar Jul 23 '23 16:07 momokid

@momokid That's great to hear !!!! are you gonna to try tackling this issue now ?? i would love you help you through any question you may have on that

jasangill1 avatar Jul 23 '23 17:07 jasangill1

@momokid That's great to hear !!!! are you gonna to try tackling this issue now ?? i would love you help you through any question you may have on that

Thank you, @jasangill1 . I will start working on it and revert if I face any issues.

momokid avatar Jul 23 '23 18:07 momokid

Hi @ja, I tried my hands on the mintlify and creating a sample docs using one of my repo. How do I go about creating the docs for AgentGPT using mintlify?

momokid avatar Jul 25 '23 11:07 momokid

Hello @momokid are you able to clone the repository for agentGPT Please launch mintlify from there and create documents on how to launch mintlify !!!

jasangill1 avatar Jul 26 '23 03:07 jasangill1

@jasangill1 Thank you so much for the support. I am almost done and will submit the changes

momokid avatar Jul 30 '23 17:07 momokid

@jasangill1 I am submitting the update with the commit message "Update documentation website guide #869". Is it ok?

momokid avatar Jul 31 '23 15:07 momokid