[jira] [Commented] (THRIFT-4710) Move all ASF CMS website content to GitHub

["Mario Emmenlauer (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/THRIFT-4710?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17045897#comment-17045897 ] 

Mario Emmenlauer commented on THRIFT-4710:
------------------------------------------

[~dcelasun] this is a very good-looking, easy to read website, nicely done!

Are there plans to publish also the auto-generated API-docs like Javadoc or doxygen for the various languages? I assume they can not easily be themed consistently but this is certainly also not a high priority. But it would be nice if the API docs and in some way be integrated / linked to from the new website.

> Move all ASF CMS website content to GitHub
> ------------------------------------------
>
>                 Key: THRIFT-4710
>                 URL: https://issues.apache.org/jira/browse/THRIFT-4710
>             Project: Thrift
>          Issue Type: Documentation
>          Components: Documentation, Website
>    Affects Versions: 0.13.0
>            Reporter: James E. King III
>            Assignee: Duru Can Celasun
>            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.
> My recommendation is to put the documentation into the "docs/" (or leave it in "doc/", perhaps, it if works) and use https://readthedocs.org/ to create the documentation web site.  Documentation updates can be pushed into the repository with {{`[ci skip]`}} or maybe we teach GitHub and/or our Appveyor and Travis to do nothing on pull requests that only contain updates to markdown and/or rst files.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)