Skip to content

create mkdocs documentation#27

Closed
antoniorodr wants to merge 1 commit intoAran404:mainfrom
antoniorodr:mkdocs
Closed

create mkdocs documentation#27
antoniorodr wants to merge 1 commit intoAran404:mainfrom
antoniorodr:mkdocs

Conversation

@antoniorodr
Copy link
Copy Markdown

Ive created basic documentation in MkDocs. The website is not created yet, but you can see the result if you run mkdocs serve and open the live server.

If you like it, I can then build the website.

Ive created a pyproject.toml too, which is the new standard for dependences.

Preview:

image

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 20, 2025

Honestly I have no clue how any of this works

@antoniorodr
Copy link
Copy Markdown
Author

Honestly I have no clue how any of this works

Do you mean the docs?

It's not that hard. I didn't knew it either, but I did read the documentation.

What do you think about the idea?

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 20, 2025

Like all that commit stuff you did

@antoniorodr
Copy link
Copy Markdown
Author

Oh, I did a contribution through a pull request. I did not change anything about the "main code". Only the necessary to have the documentation ready to be hosted and the pyproject file, which is the "new version" of the requirements.txt.

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 20, 2025

Yeah I understand that but I don't have the expertise to know if it's a correct commit 😄

@antoniorodr
Copy link
Copy Markdown
Author

I am not that experienced, but you can see the changes yourself and choose

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 20, 2025

How does Pyproject work? Do I need to update pypi or something?

@antoniorodr
Copy link
Copy Markdown
Author

How does Pyproject work? Do I need to update pypi or something?

No you don’t. I create it with uv when I create my venv.

You can read a little bit more here

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 21, 2025

We can go through with this but you'd have to hold my hand a little

@antoniorodr
Copy link
Copy Markdown
Author

Sure, what do you need?

I did not delete the requirements.txt tho.

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 21, 2025

Those docs look nice, how's that work? All this is foreign to me

@antoniorodr
Copy link
Copy Markdown
Author

Right now I just wrote a bit of the necessary "code" to make the docs as you see in the picture. If you think it's looks nice and want to use is (they have a lot of documentation, and I can try to explain a bit if you want) so can I help you to build it.

It's just a command we need to use tho.

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 21, 2025

Alright

@antoniorodr
Copy link
Copy Markdown
Author

Okay. I can do it in my fork and then update the PR, if you want?

@antoniorodr
Copy link
Copy Markdown
Author

@Aran404

On the other hand, you could accept my PR, pull it to local and use this command to build it:

mkdocs build

More information here

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 23, 2025

Will do later

@antoniorodr
Copy link
Copy Markdown
Author

Will do later

Great!

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented Mar 26, 2025

Sorry been really sick so haven't been on my pc, will get to when I'm feeling better

@antoniorodr
Copy link
Copy Markdown
Author

Sorry been really sick so haven't been on my pc, will get to when I'm feeling better

No hurry mate

@antoniorodr
Copy link
Copy Markdown
Author

@Aran404 Is this PR still valid / something you're planning to move forward with?

@Aran404
Copy link
Copy Markdown
Owner

Aran404 commented May 27, 2025

Yes sir, what do I need to do?

@antoniorodr
Copy link
Copy Markdown
Author

@Aran404

On the other hand, you could accept my PR, pull it to local and use this command to build it:

mkdocs build

More information here

You should read this comment after merging the commit, so you can proceed with building the site.

@antoniorodr
Copy link
Copy Markdown
Author

Close the PR due to lack of response.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants