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

Setup MKDocs to to upgrade and publish documentation. #1005

Closed
1 of 3 tasks
nikhil25803 opened this issue May 18, 2024 · 7 comments
Closed
1 of 3 tasks

Setup MKDocs to to upgrade and publish documentation. #1005

nikhil25803 opened this issue May 18, 2024 · 7 comments
Assignees
Labels
documentation Improvements or additions to documentation enhancement New feature or request gssoc GSSoC 2024

Comments

@nikhil25803
Copy link
Member

Describe the feature

For now, this project uses its README.md and other files combined as primary documentation. As we have covered a few modules, I look forward to adding and publishing documentation like FastAPI Link.

For the initial setup, I want someone to

  • Setup basic layout using Materials for MkDocs
  • Build the navbar section with details about GitHub
  • You can use the current readme to display on the primary page.
  • Plan about how we can add the rest of the documentation.

Add ScreenShots

image

Record

  • I agree to follow this project's Code of Conduct
  • I'm a GSSoC'24 contributor
  • I want to work on this issue
@nikhil25803 nikhil25803 added documentation Improvements or additions to documentation enhancement New feature or request gssoc GSSoC 2024 labels May 18, 2024
@nikhil25803
Copy link
Member Author

nikhil25803 commented May 18, 2024

Note - I have already set up the MkDocs.
You can use the following command to run and test the documentation files.

Commands

  • mkdocs new [dir-name] - Create a new project.
  • mkdocs serve - Start the live-reloading docs server.
  • mkdocs build - Build the documentation site.
  • mkdocs -h - Print help message and exit.

Project layout

mkdocs.yml    # The configuration file.
docs/
    index.md  # The documentation homepage.
    ...       # Other markdown pages, images and other files.

@adishgarg
Copy link
Contributor

Can i work on this issue under GSSoc'24? @nikhil25803

@nikhil25803
Copy link
Member Author

Go ahead @adishgarg

@Daksh-khandelwal-1495
Copy link

Would love to work on this issue when available !
Looking forward to it .

@nikhil25803
Copy link
Member Author

Hey @Daksh-khandelwal-1495, you can coordinate with @adishgarg and can work on other feature related to MkDocs.

Make sure to raise different PRs

@adishgarg
Copy link
Contributor

@nikhil25803 do we want to replicate the Fast API doc completely or just use it as a reference because they employ a lot of external css and js

@nikhil25803
Copy link
Member Author

For reference only @adishgarg

@nikhil25803 nikhil25803 changed the title Setup MKDocs to to uphrade and publish documentation. Setup MKDocs to to upgrade and publish documentation. May 22, 2024
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 enhancement New feature or request gssoc GSSoC 2024
Projects
None yet
Development

No branches or pull requests

3 participants