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

Documentation rework - Phase 1 #381

Merged
merged 1 commit into from
May 28, 2024
Merged

Conversation

cfusterbarcelo
Copy link
Collaborator

Documentation Rework

Changes

  • Four sections on the sidebar: Getting started, Guides, Tools and Resources, Help Desk and Terms of Service. All files have been moved to follow this structure.
  • Old, unused and empty files have been moved to /docs/deprecated
  • New sidebar do not use pointers from index.html

Phases

Phase 1 includes adding some missing information and move the files in a sensible way. Next phase will be to add new missing documentation and rework some of the existing files.

Copy link

netlify bot commented Mar 13, 2024

Deploy Preview for bioimage ready!

Name Link
🔨 Latest commit 1278043
🔍 Latest deploy log https://app.netlify.com/sites/bioimage/deploys/664dc98c82d5860008e1fd35
😎 Deploy Preview https://deploy-preview-381--bioimage.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@cfusterbarcelo
Copy link
Collaborator Author

Somehow is not working and the documentation not showing. I'll take care of it.

@cfusterbarcelo cfusterbarcelo added documentation Improvements or additions to documentation enhancement New feature or request labels Apr 3, 2024
@oeway
Copy link
Collaborator

oeway commented May 7, 2024

@carlosuc3m Is this PR ready to merged?

The BioImage Model Zoo is intended to be used by different roles in the community as stated in [How to participate in the BioImage Model Zoo](/getting_started/README.md). This section contains guides for the different roles in the community.

* **[User Guide](user_guide.md)**: Guides for users willing to download and use the models and other resources from the BioImage Model Zoo
* **[Developers Guide](developer_guide.md)**: Guides for who is willing to contribute to the BioImage Model Zoo with models, applications or softwares.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **[Developers Guide](developer_guide.md)**: Guides for who is willing to contribute to the BioImage Model Zoo with models, applications or softwares.
* **[Developers Guide](guides/developer_guide.md)**: Guides for who is willing to contribute to the BioImage Model Zoo with models, applications or softwares.

@cfusterbarcelo
Copy link
Collaborator Author

This PR is ready to deploy! 🚀🎉
@oeway : Could you resolve conflicts and merge...?

@oeway
Copy link
Collaborator

oeway commented May 22, 2024

Hi @cfusterbarcelo I just merged the changes, however, somehow the history disappeared from the commit history, sorry about that! If you have a local copy of it, feel free to merge with the remote copy in your fork, them push it again so we can restore the commit history.

I tried to render the docs website locally, it appears that the docs side bar are not working, and there are still many broken image links, could you take a look? We should also remove the deprecated folder if that's not needed, we don't make copies of these files, instead, we recover them from github history if needed. Are you sure that all the deprecated files are not need anymore?

@oeway
Copy link
Collaborator

oeway commented May 28, 2024

Looks good now, it wasn't working for some reason. I will merge and we will take it from there!

@oeway oeway merged commit a7b87c0 into bioimage-io:main May 28, 2024
6 checks passed
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
Projects
Status: Released 📢
Development

Successfully merging this pull request may close these issues.

2 participants