Re: Ivy - we have now moved to asciidoc for docs

> > I’m now pick up the “Tutorials” section. > > I’ll take care of the last pages, "Reference/Introduction" and "Developper doc". Nicolas - To unsubscribe, e-mail: dev-unsubscr...@ant.apache.org For additional commands,

Re: Ivy - we have now moved to asciidoc for docs

> Le 2 juil. 2017 à 07:23, Gintautas Grigelionis a > écrit : > > 2017-07-01 18:56 GMT+02:00 Nicolas Lalevée >: > >> >>> Le 1 juil. 2017 à 15:27, Gintautas Grigelionis >> a

Re: Ivy - we have now moved to asciidoc for docs

2017-07-01 18:56 GMT+02:00 Nicolas Lalevée : > > > Le 1 juil. 2017 à 15:27, Gintautas Grigelionis > a écrit : > > > >> Probably a thing to improve are all the « since 2.x » annotations. Maybe > > we can have a macro for that, which will render

Re: Ivy - we have now moved to asciidoc for docs

> Le 1 juil. 2017 à 15:27, Gintautas Grigelionis a > écrit : > >> Probably a thing to improve are all the « since 2.x » annotations. Maybe > we can have a macro for that, which will render everywhere the same, and > which will be placed everywhere the same. Now

Re: Ivy - we have now moved to asciidoc for docs

> Le 1 juil. 2017 à 15:31, Jaikiran Pai a écrit : > > > On 29-Jun-2017, at 11:29 AM, Jaikiran Pai wrote: > > >> I’m picking up “OSGi” section next. > > I have completed and pushed the migration of “OSGi” and “Using standalone” > sections

Re: Ivy - we have now moved to asciidoc for docs

On 29-Jun-2017, at 11:29 AM, Jaikiran Pai wrote: > I’m picking up “OSGi” section next. I have completed and pushed the migration of “OSGi” and “Using standalone” sections to upstream (it’s actually live on site since yesterday). For the OSGi pages, I had to reword

Re: Ivy - we have now moved to asciidoc for docs

> Probably a thing to improve are all the « since 2.x » annotations. Maybe we can have a macro for that, which will render everywhere the same, and which will be placed everywhere the same. Now sometimes it is at the beginning of the line, sometimes at the end, sometimes above. And I find it being

Re: Ivy - we have now moved to asciidoc for docs

Thank you. PR 49 and 50 became one big spaghetti as I tried to catch up with your work and learn the ropes :-) Now, 49 is closed and 50 is squashed. Cheers, Gintas 2017-07-01 14:07 GMT+02:00 Nicolas Lalevée : > Thank you very much Gintas. > > These PRs are huge, so

Re: Ivy - we have now moved to asciidoc for docs

On 30-Jun-2017, at 9:48 PM, Nicolas Lalevée wrote: > I have seen that you have qualified the source blocks, telling it is xml. > Then I have done the same for the 'Ivy File' and 'Ant Tasks’ sections. And I > enabled the highlightjs integration with acsiidoctor. I

Re: Ivy - we have now moved to asciidoc for docs

FWIW - I just finished reviewing PR-48 (the generics changes) https://github.com/apache/ant-ivy/pull/48/. Took me around an hour, the changes look fine :) I just have one comment/question about one of the change in that PR (I have to read up the Java spec or find some necessary documentation

Re: Ivy - we have now moved to asciidoc for docs

Thank you very much Gintas. These PRs are huge, so they will take a little bit of time to process. Also, in the PR 49 and 50 I can see a lot of commits [1] [2]. For a cleaner git history, could you rebase and squash them ? I don’t require to have one commit, for instance having the two commits

Re: Ivy - we have now moved to asciidoc for docs

I opened a PR (well, actually two :-() to fix spelling and links that still point to configuration. Gintas 2017-06-30 18:44 GMT+02:00 Gintautas Grigelionis : > terminology.adoc apparently has an incorrect link on line 150, > configuration/statuses.html should be

Re: Ivy - we have now moved to asciidoc for docs

terminology.adoc apparently has an incorrect link on line 150, configuration/statuses.html should be settings/statuses.html (I get a redirect from http://ant.apache.org/ivy/history/master/terminology.html) Gintas 2017-06-30 18:18 GMT+02:00 Nicolas Lalevée : > I have

Re: Ivy - we have now moved to asciidoc for docs

I have seen that you have qualified the source blocks, telling it is xml. Then I have done the same for the 'Ivy File' and 'Ant Tasks’ sections. And I enabled the highlightjs integration with acsiidoctor. I don’t find the default theme that cute (too lazy to search another one), but it is nicer

Re: Ivy - we have now moved to asciidoc for docs

On 29-Jun-2017, at 3:58 PM, Nicolas Lalevée wrote: > >> Le 29 juin 2017 à 07:59, Jaikiran Pai a écrit : >> >> A quick update on this one - I finished off the “settings” sections last >> week. There is only one pending item that I’m

Re: Ivy - we have now moved to asciidoc for docs

> Le 29 juin 2017 à 07:59, Jaikiran Pai a écrit : > > A quick update on this one - I finished off the “settings” sections last > week. There is only one pending item that I’m trying to address in that > section. The “Settings” page[1] has a “Settings File Structure”

Re: Ivy - we have now moved to asciidoc for docs

A quick update on this one - I finished off the “settings” sections last week. There is only one pending item that I’m trying to address in that section. The “Settings” page[1] has a “Settings File Structure” section which tries to represent the Ivy settings XML file structure as a tree. We

Re: Ivy - we have now moved to asciidoc for docs

> >> >> And just an idea: since there are a lot of pages, maybe we could organize a >> review at many, without useless double checks. I see 4 big parts in the doc: >> the ant tasks, the pages related to the ivy file, the pages related to the >> ivysettings, and the other pages. If 4

Re: Ivy - we have now moved to asciidoc for docs

I'd happy to help later tonight, please let me know if there's some particular section that I should look into. Skimming through quickly, More Examples ( http://people.apache.org/~hibou/doc/moreexamples.html) should be adjusted. Gintas 2017-06-20 4:16 GMT+02:00 Jaikiran Pai

Re: Ivy - we have now moved to asciidoc for docs

> > On 20-Jun-2017, at 3:38 AM, Nicolas Lalevée > wrote: > > >> Le 19 juin 2017 à 04:52, Jaikiran Pai a écrit : >> >> The documentation for ant-ivy project has now been migrated to asciidoc. The >> migration used a tool developed by

Re: Ivy - we have now moved to asciidoc for docs

Yes, that appears to be the only place where we explain documentation contribution. However, the IvyDE project page too points to this page. That’s a reminder for us that the IvyDE project too probably needs to move to asciidoc. -Jaikiran On 20-Jun-2017, at 3:39 AM, Nicolas Lalevée

Re: Ivy - we have now moved to asciidoc for docs

SVG is inlined as code, see http://people.apache.org/~hibou/doc/osgi.html Gintas 2017-06-20 0:09 GMT+02:00 Nicolas Lalevée : > > > Le 19 juin 2017 à 08:30, Jan Matèrne (jhm) a écrit : > > > > Doc's mentioning 'how to document' must be updated. > >

Re: Ivy - we have now moved to asciidoc for docs

> Le 19 juin 2017 à 08:30, Jan Matèrne (jhm) a écrit : > > Doc's mentioning 'how to document' must be updated. > I found http://ant.apache.org/ivy/write-doc.html Some more? This is the only page which explain xooki I know. Nicolas > > Jan > >> -Ursprüngliche

Re: Ivy - we have now moved to asciidoc for docs

> Le 19 juin 2017 à 04:52, Jaikiran Pai a écrit : > > The documentation for ant-ivy project has now been migrated to asciidoc. The > migration used a tool developed by Nicolas to migrate the xooki backed HTML > docs to asciidoc. This tool auto-generated the asciidoc