cordova-issues mailing list archives

[jira] [Commented] (CB-13162) cordova-docs should be built and published automatically on every change

Date

Wed, 09 Aug 2017 19:55:02 GMT

[ https://issues.apache.org/jira/browse/CB-13162?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16120553#comment-16120553
]
Filip Maj commented on CB-13162:
--------------------------------
These are really good suggestions. I am not sure how viable the docs in their current form
can exist as Jekyll pages, since they require some pre-processing to generate tables of contents
and link documents within the repo, but it is worth checking out.
We should most definitely explore the translation experience a bit more - none of the PMC
members have gone through this flow so I think there is very little empathy and understanding
for that flow at this point. Spending some time on that would make this an easier experience
for our translators, which sounds like, is sorely needed.
> cordova-docs should be built and published automatically on every change
> ------------------------------------------------------------------------
>
> Key: CB-13162
> URL: https://issues.apache.org/jira/browse/CB-13162
> Project: Apache Cordova
> Issue Type: Improvement
> Components: cordova-docs
> Reporter: Filip Maj
> Labels: backlog
>
> I would like to see the docs have better automation.
> My ideal situation (and I don't think this is outside the realm of possibility) is that,
on every change to cordova-docs:
> * the sources in crowdin are automatically updated (the crowdin GitHub integration does
all of this work for us)
> * the cordova-docs get automatically built into a publish-ready state
> * any languages in crowdin that have close-to-100% translation are pulled in and integrated
into the built docs
> * the built + translation-integrated docs are finally pushed/published so that docs.cordova.io
is updated automatically.
> We should also document this in the README if we ever get around to this issue :)
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org