search

SkygearIO / skygear-doc

[Deprecated] Doc site generator for all the platform guides of Skygear; Content are here: https://github.com/SkygearIO/guides/tree/v1
https://docs.skygear.io/
MIT License
4 stars 19 forks source link

Do not include guides as a submodule of this repo #530

Closed cheungpat closed 6 years ago

rickmak commented 7 years ago

Do you mean to publish this repo as display package on npm. The release should be managed at guide repo branch or tag. It will make the content control the delivery, not style/display control the delivery. Which makes more sense to me.

cheungpat commented 7 years ago

Not decided how yet, the easy way out is to add this repo as a submodule of guides, so that we don’t need to publish this repo as an npm package.

Agree on this, this is also my intention:

It will make the content control the delivery, not style/display control the delivery. Which makes more sense to me.

chpapa commented 7 years ago

Actually have this repo publish as a package to compile guides repo into HTML could be a good idea, so developers / content can preview what their wrote easier (now a lot of time I think people don't really preview it before they commit)

I have seen a few open sources project have publish a nom package with command line to turn a folder of docs into a folder of HTML, not sure if that is what @rickmak meant as display package

cheungpat commented 6 years ago

the issue as captioned has since been fixed