molstar / molstar

A comprehensive macromolecular library

Home Page:https://molstar.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

documentation is split from code: let's put it alongside code here

alisterburt opened this issue · comments

@dsehnal and I discussed putting documentation alongside the code in this repo rather than have it exist in two separate places

As I understand it, he will merge the two types of docs into this repo and I will set up CI here to build/deploy to molstar/molstar.github.io

Are we on the same page @dsehnal ?

There are two ways we can do this. One is what you suggest to push it to molstar.github.io, other is to compile the docs and push it to the gh-pages branch of this repo and map it to /docs. I think the latter will be easier to do given how things are set up now.

gotcha - #1089 is there with some CI that should work

/docs refers to https://github.com/molstar/docs I assume? I didn't know you could map a repo to a branch, cool!

Yeah molstar/docs repo maps to molstar.github.io/docs which then gets translated to molstar.org/docs. Thanks for the CI action, that will save some time.

Implemented in #1090 and https://molstar.org/docs/ is now automatically published from this repo when pushing to master. Thanks @alisterburt for the initial GHA to help with this.

Amazing @dsehnal - thanks for being willing to change structure, I know these things can be annoying but I think it's worth it long term 🙂