[
https://issues.apache.org/jira/browse/THRIFT-4710?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16732066#comment-16732066
]
James E. King III edited comment on THRIFT-4710 at 1/2/19 2:04 PM:
-------------------------------------------------------------------
I'm not sure I like that model. That means we have to check in code in one
place and then separately check in documentation in another. I would prefer
folks check in both code and supporting documentation. (but I could be
convinced otherwise if there's evidence it is beneficial) I looked at the
apache aurora website repository and it looks like it's a "run one command" to
build and publish the site which is nice.
We can separately maintain a website branch that, when pushed to, would build
the web site and trigger a web site update. The INFRA team said that they
could pull the content from any branch and (I believe) subdirectory but it has
to be in HTML. So we would need to make sure we can find a way to generate the
HTML from the markdown. I think this is all possible but will take some time.
was (Author: jking3):
I'm not sure I like that model. That means we have to check in code in one
place and then separately check in documentation in another. I would prefer
folks check in both code and supporting documentation.
We can separately maintain a website branch that, when pushed to, would build
the web site and trigger a web site update. The INFRA team said that they
could pull the content from any branch and (I believe) subdirectory but it has
to be in HTML. So we would need to make sure we can find a way to generate the
HTML from the markdown. I think this is all possible but will take some time.
> Move all website content to markdown within the project
> -------------------------------------------------------
>
> Key: THRIFT-4710
> URL: https://issues.apache.org/jira/browse/THRIFT-4710
> Project: Thrift
> Issue Type: Documentation
> Components: Documentation, Website
> Affects Versions: 0.12.0
> Reporter: James E. King III
> Priority: Major
>
> Recent changes in Apache infrastructure has made it impossible to use the
> existing ASF CMS system to manage the Apache Thrift web site. We need to
> extract and move the content somewhere else. For reference, see:
> https://issues.apache.org/jira/browse/INFRA-17519
> This is a bunch of work nobody was expecting to have to do.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
