[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14496665#comment-14496665
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit f95f34535636a589e2046eea0d8d9607055d4000 in isis's branch 
refs/heads/ISIS-1133-docs from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=f95f345 ]

ISIS-1133: reworked template to use zurb foundation, and reference the regular 
asciidoctor stylesheets; skeleton outline of about half of the website.


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14496716#comment-14496716
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit e530bda868bee7fc2fee2070186defed7908e132 in isis's branch 
refs/heads/ISIS-1133-docs from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=e530bda ]

ISIS-1133: triggering events subsection of user guide.

also:
- deleting a backup accidentally committed.


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14496720#comment-14496720
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit 79ca45f1d0e5016abb91e3b4f2281958185d1971 in isis's branch 
refs/heads/ISIS-1133-docs from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=79ca45f ]

ISIS-1133: documentation links, github msg


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14497044#comment-14497044
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit 79ca45f1d0e5016abb91e3b4f2281958185d1971 in isis's branch 
refs/heads/master from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=79ca45f ]

ISIS-1133: documentation links, github msg


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14497043#comment-14497043
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit e530bda868bee7fc2fee2070186defed7908e132 in isis's branch 
refs/heads/master from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=e530bda ]

ISIS-1133: triggering events subsection of user guide.

also:
- deleting a backup accidentally committed.


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14497042#comment-14497042
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit f95f34535636a589e2046eea0d8d9607055d4000 in isis's branch 
refs/heads/master from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=f95f345 ]

ISIS-1133: reworked template to use zurb foundation, and reference the regular 
asciidoctor stylesheets; skeleton outline of about half of the website.


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


[jira] [Commented] (ISIS-1133) Convert website to asciidoctor, hosted in git and published via ASF's svnpubsub

2015-04-15 Thread ASF subversion and git services (JIRA)

[ 
https://issues.apache.org/jira/browse/ISIS-1133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=14497022#comment-14497022
 ] 

ASF subversion and git services commented on ISIS-1133:
---

Commit ad48e0742c68e001ec75baeab340d458da7f51eb in isis's branch 
refs/heads/ISIS-1133-docs from [~danhaywood]
[ https://git-wip-us.apache.org/repos/asf?p=isis.git;h=ad48e07 ]

ISIS-1133: more outlines for user guide.


 Convert website to asciidoctor, hosted in git and published via ASF's 
 svnpubsub
 ---

 Key: ISIS-1133
 URL: https://issues.apache.org/jira/browse/ISIS-1133
 Project: Isis
  Issue Type: Improvement
  Components: Website and Docs
Affects Versions: core-1.8.0
Reporter: Dan Haywood
Assignee: Dan Haywood
 Fix For: 1.10.0


 Asciidoctor can be found here [1].
 Some reasons for doing this:
 - the source code for the website will be in git (rather than svn as 
 currently), and so will be mirrored to github.  Therefore users/contributors 
 can fork our repo and submit pull requests on the docs/website.
 - the generated content can be previewed locally; ASF's svnpubsub 
 infrastructure is used only for publishing/hosting the site
   - there are also some doubts about svnpubsub's long-term future, so we 
 should minimize our dependence on it if possible
 - the toolchain seems to exist already and is in use by at least one other 
 ASF project - Deltaspike [2] - who have got the toolchain to work.  (Wicket 
 are also experimenting, [3])
 - the generated pages are themeable either using Foundation (the default) or 
 using Bootstrap .
 - github natively understands asciidoc (.adoc) files, and are enthusiastic 
 supporters (see this article of Scott Chacon, [4])
 - there are editors for Asciidoctor, eg [5]
 - longer term, it's possible that the docs could be converted into a book, eg 
 using O'Reilly's Atlas platform [6]
 Good starting points:
 - the DeltaSpike pom.xml's.   They seem to have two separate regions; the 
 top-level site [7a,7b], and a documentation subfolder [8a,8b]
   - these use the asciidoctor-maven-plugin [9] to convert the .adoc files to 
 .html
   - these use the maven-scm-publish-plugin [10] to update the SVN (do all 
 necessary add/deletes to properly synchronize)
 - there are also some useful templates (integrated with mvn site) at [11]
 - theming with Bootstrap might be done using any of  [12] or [13a, 13b] 
 (latter is asciidoc not asciidoctor so might require some fiddling around 
 with).
 [1] http://asciidoctor.org/
 [2] http://deltaspike.apache.org/
 [3] https://github.com/dashorst/wicketguide
 [4] 
 https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272
 [5] https://github.com/asciidoctor/atom-asciidoc-preview
 [6] https://atlas.oreilly.com/
 [7a] https://github.com/apache/deltaspike/blob/master/site
 [7b] https://github.com/apache/deltaspike/blob/master/site/pom.xml
 [8a] https://github.com/apache/deltaspike/tree/master/documentation
 [8b] https://github.com/apache/deltaspike/tree/master/documentation/pom.xml
 [9] http://asciidoctor.org/docs/asciidoctor-maven-plugin/
 [10] https://maven.apache.org/plugins/maven-scm-publish-plugin/
 [11] https://github.com/asciidoctor/asciidoctor-maven-examples
 [12] https://github.com/nerk/asciidoctor-bs-themes
 [13a] https://github.com/llaville/asciidoc-bootstrap-backend
 [13b] http://laurent-laville.org/asciidoc/bootstrap/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


AW: ISIS-1085-CssClassFa

2015-04-15 Thread Rade, Joerg / Kuehne + Nagel / Ham GI-PS
Hi Martin,

thanks for the review! I'll revert the formatting changes - sorry for the noise.

I (still) use Eclipse and just discovered [1]. Something else to follow?

Best regards
Jörg

[1] http://isis.apache.org/contributors/development-environment.html


Kühne + Nagel (AG  Co.) KG
Rechtsform: Kommanditgesellschaft, Bremen HRA 21928, USt-IdNr.: DE 812773878.
Geschäftsleitung Kühne + Nagel (AG  Co.) KG: Reiner Heiken (Vors.), Dirk 
Blesius, Martin Brinkmann, Holger Ketz, Jan-Hendrik Köstergarten, Christian 
Solf, Lars Wedel, Jens Wollesen.
Persönlich haftende Gesellschafterin: Kühne  Nagel A.G., Rechtsform: 
Aktiengesellschaft nach luxemburgischem Recht, HR-Nr.: B 18745, 
Geschäftsführendes Verwaltungsratsmitglied: Karl Gernandt.
Geschäftsleitung Region Westeuropa: Yngve Ruud (Vors.), Richard Huhn, Björn 
Johansson, Jan Kunze, Bruno Mang, Stefan Paul, Holger Ketz, Dominic Edmonds.

Wir arbeiten ausschließlich auf Grundlage der Allgemeinen Deutschen 
Spediteursbedingungen (ADSp), jeweils neuester Fassung. Wir verweisen 
insbesondere auf die vom Gesetz abweichenden Haftungsbeschränkungen von Ziffer 
23 und 24 ADSp. Den vollständigen Text der ADSp übersenden wir Ihnen gerne auf 
Anfrage und können Sie auch unter http://www.kuehne-nagel.com einsehen. 
Ergänzend wird vereinbart, dass (1) Ziffer 27 ADSp im Rahmen internationaler 
Übereinkommen weder unsere Haftung noch die Zurechnung des Verschuldens von 
Leuten und sonstigen Dritten zu Gunsten des Auftraggebers erweitert, und (2) 
wir in den im deutschen Seehandelsrecht aufgeführten Fällen des nautischen 
Verschuldens oder Feuer an Bord nur für eigenes Verschulden und (3) im Sinne 
der CMNI genannten Voraussetzungen nicht für nautisches Verschulden, Feuer an 
Bord oder Mängel des Schiffes haften.


[jira] [Created] (ISIS-1136) Use maven-javadoc-plugin with doclet apiviz to generate javadoc with diagrams

2015-04-15 Thread JIRA
Jörg Rade created ISIS-1136:
---

 Summary: Use maven-javadoc-plugin with doclet apiviz to generate 
javadoc with diagrams
 Key: ISIS-1136
 URL: https://issues.apache.org/jira/browse/ISIS-1136
 Project: Isis
  Issue Type: Improvement
Reporter: Jörg Rade
Assignee: Dan Haywood
Priority: Trivial


see https://code.google.com/p/apiviz/ and http://docs.jboss.org/netty/3.0/api/



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)


Re: ISIS-1085-CssClassFa

2015-04-15 Thread Martin Grigorov
Hi,

2015-04-15 13:44 GMT+03:00 Rade, Joerg / Kuehne + Nagel / Ham GI-PS 
joerg.r...@kuehne-nagel.com:

 Hi Martin,

 thanks for the review! I'll revert the formatting changes - sorry for the
 noise.

 I (still) use Eclipse and just discovered [1]. Something else to follow?


Just check the produced diff and make sure there are no changes you didn't
make intentionally ;-)

I think Eclipse's default is to reformat the edited file.
It could be IDEA default or something that I've setup long time ago but
here IDEA formats only the lines I've modified.



 Best regards
 Jörg

 [1] http://isis.apache.org/contributors/development-environment.html


 Kühne + Nagel (AG  Co.) KG
 Rechtsform: Kommanditgesellschaft, Bremen HRA 21928, USt-IdNr.: DE
 812773878.
 Geschäftsleitung Kühne + Nagel (AG  Co.) KG: Reiner Heiken (Vors.), Dirk
 Blesius, Martin Brinkmann, Holger Ketz, Jan-Hendrik Köstergarten, Christian
 Solf, Lars Wedel, Jens Wollesen.
 Persönlich haftende Gesellschafterin: Kühne  Nagel A.G., Rechtsform:
 Aktiengesellschaft nach luxemburgischem Recht, HR-Nr.: B 18745,
 Geschäftsführendes Verwaltungsratsmitglied: Karl Gernandt.
 Geschäftsleitung Region Westeuropa: Yngve Ruud (Vors.), Richard Huhn,
 Björn Johansson, Jan Kunze, Bruno Mang, Stefan Paul, Holger Ketz, Dominic
 Edmonds.

 Wir arbeiten ausschließlich auf Grundlage der Allgemeinen Deutschen
 Spediteursbedingungen (ADSp), jeweils neuester Fassung. Wir verweisen
 insbesondere auf die vom Gesetz abweichenden Haftungsbeschränkungen von
 Ziffer 23 und 24 ADSp. Den vollständigen Text der ADSp übersenden wir Ihnen
 gerne auf Anfrage und können Sie auch unter http://www.kuehne-nagel.com
 einsehen. Ergänzend wird vereinbart, dass (1) Ziffer 27 ADSp im Rahmen
 internationaler Übereinkommen weder unsere Haftung noch die Zurechnung des
 Verschuldens von Leuten und sonstigen Dritten zu Gunsten des Auftraggebers
 erweitert, und (2) wir in den im deutschen Seehandelsrecht aufgeführten
 Fällen des nautischen Verschuldens oder Feuer an Bord nur für eigenes
 Verschulden und (3) im Sinne der CMNI genannten Voraussetzungen nicht für
 nautisches Verschulden, Feuer an Bord oder Mängel des Schiffes haften.