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

nimdocs.com going away #125

Closed
guzba opened this issue May 14, 2023 · 9 comments · Fixed by #126 or #136
Closed

nimdocs.com going away #125

guzba opened this issue May 14, 2023 · 9 comments · Fixed by #126 or #136

Comments

@guzba
Copy link

guzba commented May 14, 2023

Hello, I wanted to give this repo a quick heads-up that nimdocs.com, which @treeform and I have been running, is going away in favor of using Github Actions + Github Pages.

nimdocs.com is currently linked to from this repo's readme for documentation.

My suggestion:

Add this Github Actions workflow file: https://github.com/treeform/nimtemplate/blob/master/.github/workflows/docs.yml (no need to change anything) to automatically generate docs in a branch called gh-pages. This branch will have the Docs content updated each push.

In the repo settings Page tab, you can then select that branch to serve (once the job has run once).

After that, https://nim-lang.github.io/bigints/ should be serving the most recently generated docs.

This is simpler than us running a server and all of that stuff and just as easy for repo maintainers so I think it is a better model.

I'll keep the server up for a bit yet but it is going away.

@dlesnoff
Copy link
Contributor

@guzba Thanks for the notification, I am going to make a PR tonight.

@pietroppeter
Copy link
Contributor

pietroppeter commented May 17, 2023

Still to do:

  • activate GitHub pages in the repo (they are not active otherwise the GitHub.io link above would work)
  • update link to docs in the readme

@narimiran narimiran reopened this May 17, 2023
@dlesnoff
Copy link
Contributor

@narimiran Can you activate the GitHub pages in the repo?
My PR broke the YAML file.

@narimiran
Copy link
Member

It should be activated now. Please let me know if it doesn't work.

@dlesnoff
Copy link
Contributor

Thanks for the activation. I can indeed read the README.md file at the given link. Yet, I can not read the documentation of the library. I will look that up later.

@konsumlamm
Copy link
Contributor

@narimiran did you select the gh-pages branch for deployment (Settings -> Pages -> Branch)?

@narimiran
Copy link
Member

@narimiran did you select the gh-pages branch for deployment (Settings -> Pages -> Branch)?

Now I did :)

@konsumlamm
Copy link
Contributor

Nice, now it works.

@dlesnoff
Copy link
Contributor

Thanks for fixing that!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
5 participants