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 <jai.forums2...@gmail.com>: > > > > On 20-Jun-2017, at 3:38 AM, Nicolas Lalevée <nicolas.lale...@hibnet.org> > wrote: > > > > > >> Le 19 juin 2017 à 04:52, Jaikiran Pai <jai.forums2...@gmail.com> 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 > text and for most part no other changes were needed. However, there are > some fixes the generated asciidoc will need which I’m doing and will > continue to do in the coming days to fix any issues with the generated doc. > Once the fixes are done, soon, we’ll remove the xooki backed documentation > completely from our git repo. For now though, any new documentation or > changes should go into the asciidoc files. > > > > I did a general grep about finding non translated html markup, and I > have cleaned the ones I have found. > > I have pushed the result here: http://people.apache.org/~hibou/doc/ < > http://people.apache.org/~hibou/doc/> > > > > Probably we can start pushing it to the site, since there is section > dedicated to the trunk version of the doc (which should be probably renamed > master). > > http://ant.apache.org/ivy/history/trunk/index.html < > http://ant.apache.org/ivy/history/trunk/index.html> > > It would be an opportunity to get an idea of what would it mean when a > release will happen. > > I actually forgot to send a mail yesterday, but I setup our nightly Ivy > job on Jenkins to publish the latest generated docs as build artifact so > that it gives everyone a chance to view/review it. It’s here > https://builds.apache.org/view/A/view/Ant/job/Ivy-NightlyDistribution/ > lastSuccessfulBuild/artifact/build/. We could just push it to the site > under master but I wasn’t too sure if it’s the right time to do that or if > we should just cleanup the rest of the issues in the doc before starting to > push it there. > > > > > 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 volunteers can do a > quick review of each page, I think we can be pretty confident that we > didn’t leave any ugliness somewhere. The goal wouldn’t to do a fine grain > review, but ensure that everything is readable. wdyt ? > > > > Sounds a good idea. I’ll start off with the “Settings” which relates to > the Ivy settings file. > > -Jaikiran > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@ant.apache.org > For additional commands, e-mail: dev-h...@ant.apache.org > >
