You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@cordova.apache.org by GitBox <gi...@apache.org> on 2021/08/22 05:50:19 UTC
[GitHub] [cordova-docs] erisu opened a new pull request #1197: docs(archive-20210820): add snapshot
erisu opened a new pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197
### Motivation and Context
Archive language docs.
This PR will push the archive docs directly to the deployed website.
This PR should not be merged in before https://github.com/apache/cordova-docs/pull/1196. We need to sure that the archive directory is not removed by the deploy process. This is handeled in the https://github.com/apache/cordova-docs/pull/1196 PR.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of our already generated content from "cordova.apache.org". It also has slight modifications. E.g. the archive will no longer have an edit this page icon, version dropdown, language dropdown. The dropdown content changes with new releases and we will NOT update OR maintainting OR accept PRs to update archive. It is frozen permanently. ALSO the header navigation has been completely replaced with a single link to the latest docs. Again, we do not want to manage when navs are added or removed.
Archive is a one time push, no future updates, NO code in master.
https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu commented on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu commented on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903226228
IF we merge in this PR, then that means the blog post would be updated. IT would say, "we have deprcated and archived our language docs". We would not say "removed".
With that in mind, I think it technically means we do not need to wait 2 weeks to hear users voice or concerns. We are not removing.
It would also mean the htaccess rewrite rule just need to redirect non-English docs to `/archive/docs/<lang>/...` instead.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of our already generated content from "cordova.apache.org". It also has slight modifications. E.g. the archive will no longer have an edit this page icon, version dropdown, language dropdown. These change as new releases are made and we will not be updating archive. It is frozen. ALSO the header navigation has been replaced with a single link to the latest docs. Again if the nav gets new items we do not want to manage the archive.
Archive is a one time push, no future updates, NO code in master.
https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] purplecabbage merged pull request #1197: doc(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
purplecabbage merged pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of our already generated content from "cordova.apache.org". It also has slight modifications. E.g. the archive will no longer have an edit this page icon, version dropdown, or language dropdown. The dropdown content changes with new releases and we will NOT update OR maintainting OR accept PRs to update archive. It is frozen permanently. ALSO the header navigation has been completely replaced with a single link to the latest docs. Again, we do not want to manage when navs are added or removed.
Archive is a one time push, no future updates, NO code in master.
https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of our already generated content from "cordova.apache.org". It also has slight modifications. E.g. the archive will no longer have edit this page icon, version dropdown, or language dropdown. The dropdown content in the live docs changes with new releases. We DO NOT want to update OR maintain OR accept PRs to the archive. It is frozen permanently. ALSO, the header navigation items have been replaced with a single link to the latest docs. Again, we do not want to manage the navigation items of the archive when the live site is updated.
The archive is a one-time push, with no future updates, NO code in master.
Archive Example: https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] dblotsky commented on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
dblotsky commented on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903322518
@erisu @purplecabbage to me personally, the idea of archiving is *extremely* appealing. What do you think of switching to that route?
@erisu I would still advocate for at least a few days' delay to give readers time to at least feel heard. I think if we do the change at the same time as the announcement, some folks will be upset.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of our already generated content from "cordova.apache.org". It also has slight modifications. E.g. the archive will no longer have edit this page icon, version dropdown, or language dropdown. The dropdown content in the live docs changes with new releases. We DO NOT want to update OR maintain OR accept PRs to the archive. It is frozen permanently. ALSO, the header navigation items have been replaced with a single link to the latest docs. Again, we do not want to manage the navigation items of the archive when the live site is updated.
The archive is a one-time push, with no future updates, NO code in master.
https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903226228
IF we merge in this PR, then that means the blog post would be updated. IT would say, "we have deprcated and archived our language docs". We would not say "removed".
With that in mind, I think it technically means we do not need to wait 2 weeks to hear users voice or concerns. We are not removing.
It would also mean the htaccess rewrite rule just need to redirect non-English docs to `/archive/docs/<lang>/...` instead.
Side Note: The archive snapshot is 286 MB.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] dblotsky commented on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
dblotsky commented on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903218513
@erisu is this part of the effort to obsolete the translations?
1. If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
2. Also, will it still reference the same CSS files as the main site, or will those also get archived?
IMO either is fine, but just want to confirm that this is indeed what will be happening.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu commented on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu commented on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of the already generated content from "cordova.apache.org".
https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] erisu edited a comment on pull request #1197: docs(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
erisu edited a comment on pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197#issuecomment-903223909
> is this part of the effort to obsolete the translations?
I personally dont care which way this PR goes. It is just an alternative option for keeping our gibberish Lorem Ipsum equivalent translated docs.
> If so, does that mean that the archive will be "pre-rendered", and will no longer get future template/styling changes?
It is an extract of our already generated content from "cordova.apache.org". It also has slight modifications. E.g. the archive will no longer have an edit this page icon, version dropdown, or language dropdown. The dropdown content changes with new releases and we will NOT update OR maintain OR accept PRs to update the archive. It is frozen permanently. ALSO the header navigation has been completely replaced with a single link to the latest docs. Again, we do not want to manage when navs are added or removed.
Archive is a one time push, no future updates, NO code in master.
https://erisu.github.io/cordova-docs-archived/
> Also, will it still reference the same CSS files as the main site, or will those also get archived?
No the assets are all archived. That includes CSS, Images, Favicon, JS.... everything.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org
[GitHub] [cordova-docs] purplecabbage merged pull request #1197: doc(archive-20210820): add snapshot
Posted by GitBox <gi...@apache.org>.
purplecabbage merged pull request #1197:
URL: https://github.com/apache/cordova-docs/pull/1197
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@cordova.apache.org
For additional commands, e-mail: issues-help@cordova.apache.org