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

Ioan Eugen Stan commented on JAMES-3226:
----------------------------------------

I thins we should use GitHub Pages for our staging website and use james.a.o 
(ASF Infra) for production [https://infra.apache.org/github-pages.html] .

I'll setup a staging website for James so we can view it there.

 

> Provide a process around documentation publishing and deployment
> ----------------------------------------------------------------
>
>                 Key: JAMES-3226
>                 URL: https://issues.apache.org/jira/browse/JAMES-3226
>             Project: James Server
>          Issue Type: Sub-task
>            Reporter: Ioan Eugen Stan
>            Assignee: Ioan Eugen Stan
>            Priority: Major
>
> We have started working on the documentation and it's great.
> We should also document the processes around documentation:
> - when we publish the docs
> - how to publish the docs
> - where to publish the docs
> - when we retire old docs ?!
> This task should aggregate discussion and decisions.
> The process should be written as asciidoc.
> We decided to use antora as a documentation system so the features are going 
> to depend on that technology. 
> We should have documentation for every release we make. 
> This is important since  people don't upgrade immediately after release and 
> might use an older release for some time.
> I'm not sure if the documentation for all versions should be online.
> We can build zip archives of each documentation release and include it in the 
> binary release  or publish them for download next to it. 
> This way we can keep only the latest 1-3 versions online.



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

---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org

Reply via email to