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

modernize packaging #1155

Open
2 of 8 tasks
cbm755 opened this issue Jun 28, 2022 · 5 comments
Open
2 of 8 tasks

modernize packaging #1155

cbm755 opened this issue Jun 28, 2022 · 5 comments
Milestone

Comments

@cbm755
Copy link
Collaborator

cbm755 commented Jun 28, 2022

I looked at this:

https://github.com/gnu-octave/packages/blob/main/CONTRIBUTING.md

Still todo:

  • learn connection if any between old octave-forge and new site
  • Use actions to automate releases on tag push #1166
  • update the how to release instructions (on wiki or in source?)
  • more updates to HOWTO-release, maybe strikeout the bits about tagging on legacy OctaveForge
  • update DESCRIPTION?
    • remove/edit the note in the README file that discusses Github/sourceforge
  • host docs somewhere? Still on OctaveForge is one option
  • other stuff?
@cbm755 cbm755 added this to the 3.0.0 milestone Jun 28, 2022
@cbm755
Copy link
Collaborator Author

cbm755 commented Jul 1, 2022

See this post: https://octave.discourse.group/t/welcome-octave-packages/2954

This simplifies releases overall but some decisions will be needed, such as where to host the docs. See thread.

@cbm755
Copy link
Collaborator Author

cbm755 commented Jul 1, 2022

@alexvong243f strong feelings about any of this? I haven't looked into the issue of hosting the docs but other than that I can do the actual release whenever.

(I suggest later we try to automate it with Github Actions)

@cbm755
Copy link
Collaborator Author

cbm755 commented Jul 4, 2022

@alexvong243f I think we should do the 3.0.0 release in the traditional way, bumping most of these decisions to a later release. Sound ok?

@cbm755 cbm755 modified the milestones: 3.0.0, 3.1.0 Jul 4, 2022
@alexvong243f
Copy link
Collaborator

alexvong243f commented Jul 4, 2022

No problem, we can make those decisions later.

For the docs, I think it depends whether we want to use latex in the docs. If we don't need latex rendering, we can host them in the git repo as markdown files. We can always convert them to other formats using e.g. pandoc and host them somewhere else (e.g. readthedocs). On the other hand, if we do need latex rendering, we may need some other solutions. What do you think?

@cbm755
Copy link
Collaborator Author

cbm755 commented Jul 5, 2022

They are statically generated (that's what make html does). Specifically the docs are: https://octave.sourceforge.io/symbolic/overview.html

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

No branches or pull requests

2 participants